One other thing. It appears that the docs are being wrapped so the lines are never longer than something like 75 chars or something like that. What number is being used for this so I can make all the networking docs consistent as I work on this. I think 80 chars is pretty standard, but we seem to be using something less than that, so I want to verify that unit if possible...
Thx, ws On Fri, May 16, 2014 at 11:02 AM, Will Stevens <wstev...@cloudops.com>wrote: > The two docs that are currently referenced in the index.rst are > 'networking.rst' and 'networking2.rst'. The file 'managing_networks.rst' > file seems to be almost identical to 'networking2.rst' other than having a > bit more detail in some places and there being changes in formatting. > > Lots of things like this: > 'networking2.rst' => |add-ip-range.png| > 'managing_networks.rst' => |add-ip-range.png: adding an IP range to a > network.| > > Or things like this: > 'networking2.rst' => Environment <http://tools.ietf.org/html/rfc5517>`_ > 'managing_networks.rst' => Environment <http://tools.ietf.org/html/rfc5517 > >`__ > > It is looking like one file is the predecessor of the other. Since > 'networking2.rst' is the one that is linked in the 'index.rst' file, is > that the master version of that documentation and the one I should be > working from? > > Thanks, > > Will > > > On Tue, May 13, 2014 at 4:16 AM, sebgoa <run...@gmail.com> wrote: > >> >> On May 12, 2014, at 4:29 PM, Will Stevens <wstev...@cloudops.com> wrote: >> >> > Hi All, >> > I have been building documentation for the Palo Alto Networks firewall >> > integration which I would like to add to the Administration Guide. >> > >> > I have currently built the Palo Alto integration doc as a stand alone >> doc, >> > but I will be tweaking it in order to include it in >> > the Administration Guide. >> > >> > Looking at the Administration Guide, I am noticing that the 'Managing >> > Networks and Traffic' section is very long and a bit difficult to >> manage as >> > it is. >> > >> > I am wondering if it makes sense to have a 'networking' folder and each >> of >> > the subsections in that section be broken out into its own file which is >> > then included into the 'networking2.rst' file. >> > >> > I am willing to work on this if you agree that this will simplify the >> > management of this section of the documentation. >> > >> >> +1 >> >> The all networking section in the admin guide needs to be cleaned up, >> there are currently three files: >> -networking.rst >> -networking2.rst >> -managing_networks.rst >> >> these files may have duplication and need to be organized much better >> >> have at it >> >> -sebastien >> >> > Cheers, >> > >> > Will >> >> >
