From mboxrd@z Thu Jan  1 00:00:00 1970
From: Matthew Hall <mhall@mhcomputing.net>
Subject: UX Bug in Sphinx HTML Layout for Programming Guide (and
 maybe other guides?)
Date: Wed, 13 Jan 2016 12:26:29 -0500
Message-ID: <20160113172629.GA9710@mhcomputing.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
To: dev@dpdk.org
Return-path: <dev-bounces@dpdk.org>
Received: from mail.mhcomputing.net (master.mhcomputing.net [74.208.228.170])
 by dpdk.org (Postfix) with ESMTP id 94E648E70
 for <dev@dpdk.org>; Wed, 13 Jan 2016 18:26:30 +0100 (CET)
Content-Disposition: inline
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>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

When you go to this link:

http://dpdk.org/doc/guides/prog_guide/perf_opt_guidelines.html

There is a bug in the Sphinx layout, where the subchapters of a chapter are
invisible even after the chapter is clicked.

It is a pain when you are trying to figure out the different sections in a 
widely variable chapter like the performance chapter, to know which section to 
read without having to click one-by-one to find the right part.

I am not sure about what it would take to show the subchapters in the outline 
view to make this easier for someone to figure out. Or maybe a TOC for a 
chapter at the beginning of the chapter?

This would really help a lot.

Sincerely,
Matthew.