On Thu, Oct 13, 2016 at 9:32 AM, Ben Pfaff <b...@ovn.org> wrote: > On Thu, Oct 13, 2016 at 09:10:58AM -0400, Russell Bryant wrote: > > On Thu, Oct 13, 2016 at 6:00 AM, Stephen Finucane <step...@that.guru> > wrote: > > > > > On 2016-10-12 20:20, Russell Bryant wrote: > > > > > >> On Sat, Oct 8, 2016 at 12:30 PM, Stephen Finucane <step...@that.guru> > > >> wrote: > > >> > > >> I'm going to dripfeed the conversion patches to avoid overloading > > >>> peoples (there are ~25 of them so far). This is the first batch. > > >>> > > >>> Stephen Finucane (9): > > >>> dist-docs: Add support for rST > > >>> doc: Convert INSTALL to rST > > >>> doc: Convert INSTALL.DPDK to rST > > >>> doc: Convert INSTALL.Debian to rST > > >>> doc: Convert INSTALL.Docker to rST > > >>> doc: Convert INSTALL.Windows to rST > > >>> doc: Convert INSTALL.userspace to rST > > >>> doc: Convert INSTALL.XenServer to rST > > >>> doc: Convert INSTALL.KVM to rST > > >>> > > >> > > >> Do you have the end result published anywhere? It would be nice to > > >> see the before and after before diving into the detailed reviews. > > >> > > > > > > I visually inspected them myself but I haven't published them anywhere. > > > You can run 'make dist-docs' and visually compare the resulting HTML > files > > > to what's on openvswitch.org (remembering that the reStructuredText > > > versions should actually be more complete due to latent bugs in the > > > Markdown versions). I could find somewhere to publish them if it would > help > > > but I don't know if it's really necessary :) > > > > > > To be honest though, I don't know how detailed we need to be right now. > > > IMO if the functional aspects of these patches work (i.e. the > 'dist-docs' > > > target generates sane HTML for all rST files) and we haven't lost any > of > > > the raw information then any stylistic issues I may have introduced > can be > > > fixed in follow up patches. Most of these docs are going to get > shuffled > > > around or rewritten when we start moving to sphinx anyway, so we'll > have > > > the chance to really review the content itself then. > > > > > > > OK, sounds good. I also see the previous conversation about this work > > now. Sorry about that. I'm on board with all of this. > > > > Ben, I'm happy to review all of the patches for this conversion if you'd > > like. > > That would be really valuable, thanks Russell! >
No problem, consider it delegated. -- Russell Bryant _______________________________________________ dev mailing list dev@openvswitch.org http://openvswitch.org/mailman/listinfo/dev
