From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <john.mcnamara@intel.com>
Received: from mga01.intel.com (mga01.intel.com [192.55.52.88])
 by dpdk.org (Postfix) with ESMTP id E57C8D528
 for <dev@dpdk.org>; Fri, 11 Nov 2016 14:53:41 +0100 (CET)
Received: from orsmga004.jf.intel.com ([10.7.209.38])
 by fmsmga101.fm.intel.com with ESMTP; 11 Nov 2016 05:53:40 -0800
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.31,621,1473145200"; d="scan'208";a="30088347"
Received: from irsmsx102.ger.corp.intel.com ([163.33.3.155])
 by orsmga004.jf.intel.com with ESMTP; 11 Nov 2016 05:53:39 -0800
Received: from irsmsx103.ger.corp.intel.com ([169.254.3.190]) by
 IRSMSX102.ger.corp.intel.com ([169.254.2.226]) with mapi id 14.03.0248.002;
 Fri, 11 Nov 2016 13:53:39 +0000
From: "Mcnamara, John" <john.mcnamara@intel.com>
To: "dev@dpdk.org" <dev@dpdk.org>
Thread-Topic: [PATCH v1] doc: rearrange the high level documentation index
Thread-Index: AQHSPCHw4PleOdezL0u2Nx6+rxB/3aDTzDfg
Date: Fri, 11 Nov 2016 13:53:38 +0000
Message-ID: <B27915DBBA3421428155699D51E4CFE20264D84C@IRSMSX103.ger.corp.intel.com>
References: <1478871955-6106-1-git-send-email-john.mcnamara@intel.com>
In-Reply-To: <1478871955-6106-1-git-send-email-john.mcnamara@intel.com>
Accept-Language: en-GB, en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-ctpclassification: CTP_IC
x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiMjAzZmYzOWUtNThlMy00N2MxLWFkZTEtZjA5YmFmM2M1ZGM2IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE1LjkuNi42IiwiVHJ1c3RlZExhYmVsSGFzaCI6Imhob1g3ZUVESU9OY0hTQlZJRjNKUXZWZUIwTzU3MnJhc21uWXNpZElIRWM9In0=
x-originating-ip: [163.33.239.181]
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Subject: Re: [dpdk-dev] [PATCH v1] doc: rearrange the high level
	documentation index
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: patches and discussions about DPDK <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Fri, 11 Nov 2016 13:53:42 -0000

> -----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
>=20
> Rearrange the order of the high level documenation index into a more
> logical sequence for a new user.
>=20
> Also, improve some of the high-level document names.
>=20
> Signed-off-by: John McNamara <john.mcnamara@intel.com>
> ---
>=20
> After this patch the high-level index will look like this:
>=20
>     DPDK documentation
>=20
>     * 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     =20
        * Network Interface Controller Drivers
        * Crypto Device Drivers
        * Xen Guide
    * ...