[dpdk-dev,v1] doc: rearrange the high level documentation index

  Rearrange the order of the high level documenation index into
a more logical sequence for a new user.

Also, improve some of the high-level document names.

Signed-off-by: John McNamara <john.mcnamara@intel.com>
---

After this patch the high-level index will look like this:

    DPDK documentation

    * Getting Started Guide for Linux
    * Getting Started Guide for FreeBSD
    * Sample Applications User Guides
    * Programmer's Guide
    * HowTo Guides
    * DPDK Tools User Guides
    * Testpmd Application User Guide
    * Network Interface Controller Drivers
    * Crypto Device Drivers
    * Xen Guide
    * Contributor's Guidelines
    * Release Notes
    * FAQ


 doc/guides/howto/index.rst         |  4 ++--
 doc/guides/index.rst               | 14 +++++++-------
 doc/guides/sample_app_ug/index.rst |  4 ++--
 doc/guides/tools/index.rst         |  4 ++--
 4 files changed, 13 insertions(+), 13 deletions(-)
  

> -----Original Message-----
> From: Mcnamara, John
> Sent: Friday, November 11, 2016 1:46 PM
> To: dev@dpdk.org
> Cc: Mcnamara, John <john.mcnamara@intel.com>
> Subject: [PATCH v1] doc: rearrange the high level documentation index
> 
> Rearrange the order of the high level documenation index into a more
> logical sequence for a new user.
> 
> Also, improve some of the high-level document names.
> 
> Signed-off-by: John McNamara <john.mcnamara@intel.com>
> ---
> 
> After this patch the high-level index will look like this:
> 
>     DPDK documentation
> 
>     * Getting Started Guide for Linux
>     * Getting Started Guide for FreeBSD
>     * Sample Applications User Guides
>     * Programmer's Guide
>     * HowTo Guides
>     * DPDK Tools User Guides
>     * Testpmd Application User Guide
>     * Network Interface Controller Drivers
>     * Crypto Device Drivers
>     * Xen Guide
>     * Contributor's Guidelines
>     * Release Notes
>     * FAQ

P.S.,

I would prefer not to have some of these are highest level items such as
"Xen Guide", and possibly "Crypto Device Drivers". Perhaps we could push
them down a level with "Network Interface Controller Drivers" under a
"Devices and Drivers" (or similar) section like:

    * ...
    * Programmer's Guide
    * HowTo Guides
    * DPDK Tools User Guides
    * Devices and Drivers      
        * Network Interface Controller Drivers
        * Crypto Device Drivers
        * Xen Guide
    * ...
  

2016-11-11 13:53, Mcnamara, John:
> I would prefer not to have some of these are highest level items such as
> "Xen Guide", and possibly "Crypto Device Drivers". Perhaps we could push
> them down a level with "Network Interface Controller Drivers" under a
> "Devices and Drivers" (or similar) section like:
> 
>     * ...
>     * Programmer's Guide
>     * HowTo Guides
>     * DPDK Tools User Guides
>     * Devices and Drivers      
>         * Network Interface Controller Drivers
>         * Crypto Device Drivers
>         * Xen Guide

Yes it may be an idea.
But as we will continue to support Xen Dom0, I think Xen should have
a special place somewhere (in Linux guide or separated)?
  

2016-11-11 13:45, John McNamara:
> Rearrange the order of the high level documenation index into
> a more logical sequence for a new user.
> 
> Also, improve some of the high-level document names.
> 
> Signed-off-by: John McNamara <john.mcnamara@intel.com>

Applied, thanks