From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id 674B0379E for ; Thu, 14 Jan 2016 13:12:55 +0100 (CET) Received: from orsmga001.jf.intel.com ([10.7.209.18]) by orsmga103.jf.intel.com with ESMTP; 14 Jan 2016 04:12:54 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.22,294,1449561600"; d="scan'208";a="860392210" Received: from irsmsx110.ger.corp.intel.com ([163.33.3.25]) by orsmga001.jf.intel.com with ESMTP; 14 Jan 2016 04:12:53 -0800 Received: from irsmsx111.ger.corp.intel.com (10.108.20.4) by irsmsx110.ger.corp.intel.com (163.33.3.25) with Microsoft SMTP Server (TLS) id 14.3.248.2; Thu, 14 Jan 2016 12:12:52 +0000 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.143]) by irsmsx111.ger.corp.intel.com ([169.254.2.110]) with mapi id 14.03.0248.002; Thu, 14 Jan 2016 12:12:52 +0000 From: "Mcnamara, John" To: Matthew Hall , "dev@dpdk.org" Thread-Topic: [dpdk-dev] UX Bug in Sphinx HTML Layout for Programming Guide (and maybe other guides?) Thread-Index: AQHRTiekeF9eUENOzkS+a892amuqup766UKg Date: Thu, 14 Jan 2016 12:12:52 +0000 Message-ID: References: <20160113172629.GA9710@mhcomputing.net> In-Reply-To: <20160113172629.GA9710@mhcomputing.net> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [163.33.239.180] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] UX Bug in Sphinx HTML Layout for Programming Guide (and maybe other guides?) X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 14 Jan 2016 12:12:55 -0000 > -----Original Message----- > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Matthew Hall > Sent: Wednesday, January 13, 2016 5:26 PM > To: dev@dpdk.org > Subject: [dpdk-dev] UX Bug in Sphinx HTML Layout for Programming Guide > (and maybe other guides?) >=20 > When you go to this link: >=20 > http://dpdk.org/doc/guides/prog_guide/perf_opt_guidelines.html >=20 > There is a bug in the Sphinx layout, where the subchapters of a chapter > are invisible even after the chapter is clicked. Hi Matthew, It seems to be an issue with the way the documentation section headings are structured and with the new "ReadTheDocs" theme that we introduced for the DPDK 2.2 documentation. Basically, because the heading underline formats are not consistent they don't show up as subsections in the sidebar. The previous themes used for the docs were more forgiving about this. In theory the subsections should show up. See this simplified example: http://imgur.com/qkgxGvX I'll look into fixing it.=20 In the meantime use the index.html pages of the various docs to navigate, e= .g. http://dpdk.org/doc/guides/prog_guide/index.html John. --=20