cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebgoa <run...@gmail.com>
Subject Re: [DOCS] Using Includes in the Administration Guides
Date Tue, 13 May 2014 08:16:11 GMT

On May 12, 2014, at 4:29 PM, Will Stevens <wstevens@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


Mime
View raw message