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 > >
