edgent-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Kathy Saunders <oskssaund...@gmail.com>
Subject Re: [jira] [Commented] (QUARKS-104) Documentation website consistency improvements
Date Thu, 07 Apr 2016 14:33:31 GMT
> >
> > Some parts of the documentation site are inconsistent with each other,
> such as capitalization and differences between the sidebar titles and page
> titles.
> > Possible improvements:
> > # Remove the numbering of subsections (i.e., "Get Started", "Sample
> Programs", "Using The Console")
> > # Commit to using title case capitalization (i.e., all words
> capitalized, except for minor words such as 'the', 'of', 'to', etc.) for
> sidebar/page titles and sentence case capitalization (i.e., first word
> capitalized) for page headers
> > # Redundant headers should be removed (e.g., see [Common Quarks
> Operations|
> http://quarks.incubator.apache.org/docs/common-quarks-operations.html])
> > # Page headers should start at level 2 using &#35;&#35; in order to have
> them added to the Table of Contents
>
> +1 These sound like good changes to me.

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message