Return-Path: X-Original-To: apmail-aurora-issues-archive@minotaur.apache.org Delivered-To: apmail-aurora-issues-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id C5DD89215 for ; Tue, 23 Dec 2014 20:09:38 +0000 (UTC) Received: (qmail 57974 invoked by uid 500); 23 Dec 2014 20:09:38 -0000 Delivered-To: apmail-aurora-issues-archive@aurora.apache.org Received: (qmail 57928 invoked by uid 500); 23 Dec 2014 20:09:38 -0000 Mailing-List: contact issues-help@aurora.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@aurora.incubator.apache.org Delivered-To: mailing list issues@aurora.incubator.apache.org Received: (qmail 57905 invoked by uid 99); 23 Dec 2014 20:09:38 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 23 Dec 2014 20:09:38 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED,T_RP_MATCHES_RCVD X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO mail.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with SMTP; Tue, 23 Dec 2014 20:09:17 +0000 Received: (qmail 57460 invoked by uid 99); 23 Dec 2014 20:09:14 -0000 Received: from arcas.apache.org (HELO arcas.apache.org) (140.211.11.28) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 23 Dec 2014 20:09:14 +0000 Date: Tue, 23 Dec 2014 20:09:14 +0000 (UTC) From: "Dave Lester (JIRA)" To: issues@aurora.incubator.apache.org Message-ID: In-Reply-To: References: Subject: [jira] [Updated] (AURORA-981) Dynamically generate table of contents for documentation MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 X-Virus-Checked: Checked by ClamAV on apache.org [ https://issues.apache.org/jira/browse/AURORA-981?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Dave Lester updated AURORA-981: ------------------------------- Labels: Website (was: ) > Dynamically generate table of contents for documentation > -------------------------------------------------------- > > Key: AURORA-981 > URL: https://issues.apache.org/jira/browse/AURORA-981 > Project: Aurora > Issue Type: Task > Components: Documentation > Reporter: Dave Lester > Assignee: Dave Lester > Labels: Website > > The Aurora documentation tends to be lengthy, and as a result many pages require a table of contents to easily navigate their contents. This is currently maintained manually, and has a few shortcomings: > 1) It becomes out of date quickly as documents are revised > 2) It cannot be easily styled without adding additional markup > 3) There are large inconsistencies in the ToC that documents currently have > Instead, I'd like to see us remove the static ToC that currently exists in the docs, and instead generate them when they are rendered by the website's Middleman CMS. -- This message was sent by Atlassian JIRA (v6.3.4#6332)