[P4-design] Converting P4_16 spec to html

Chris Dodd chris at barefootnetworks.com
Wed Oct 19 11:57:36 EDT 2016


I think that would be even worse than word for seeing diffs and merging
stuff, as html is unreadable without tools and tools tend to randomly munge
it.

If we want something that is diff-able and merge-able, latex is basically
the only choice.

On Wed, Oct 19, 2016 at 8:48 AM, Mihai Budiu <mbudiu at vmware.com> wrote:

> Hello.
>
>
>
> Would it be a good idea to convert the spec to html + css? This would make
> it easier to see diffs and accept contributions on github – especially
> these days there are a lot of small edits. The html would probably have to
> be hand-written and edited, since most tools generate very complicated
> structures. I imagine there would be some significant one-time effort
> converting from word.
>
>
>
> Also, an html spec is easier to share on the web. However, html is
> probably not as pleasant to convert to pdf.
>
>
>
> Mihai
>
> _______________________________________________
> P4-design mailing list
> P4-design at lists.p4.org
> http://lists.p4.org/mailman/listinfo/p4-design_lists.p4.org
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.p4.org/pipermail/p4-design_lists.p4.org/attachments/20161019/800d31b1/attachment-0002.html>


More information about the P4-design mailing list