[jboss-as7-dev] Documentation headers

[Dan Allen]

Manning (publisher) was adamant about having their authors use
Sentence capitalization for headings. O'Reilly and Apress appear to use the
Title Case format.

Personally, I find the Sentence capitalization easier to read, and easier to
get right (since that's how we write most of the time).

-Dan

On Tue, Jul 5, 2011 at 17:44, Misty Stanley-Jones <misty at redhat.com> wrote:

> h3++! Sentence case is better than Title Case.
>
> ----- Original Message -----
> > From: "Kabir Khan" <kabir.khan at jboss.com>
> > To: "JBoss AS7 Development" <jboss-as7-dev at lists.jboss.org>
> > Sent: Tuesday, July 5, 2011 8:56:06 PM
> > Subject: [jboss-as7-dev] Documentation headers
> > The capitalization of the headers in the docs is a bit arbitrary
> >
> > Some Places We Do This
> > Other places use this
> >
> > This needs to be standardized. Either we choose one of the two options
> > or
> >
> > h1 + h2: We Use This
> > h3++: We use this
> > _______________________________________________
> > jboss-as7-dev mailing list
> > jboss-as7-dev at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/jboss-as7-dev
>
> --
>
>
> Misty Stanley-Jones, RHCE
> Content Author, ECS Brisbane
> ☺: misty (Freenode IRC) ✉: misty at redhat.com ☏: +61 7 3514 8105 ☏: 88105
>
> _______________________________________________
> jboss-as7-dev mailing list
> jboss-as7-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev
>



-- 
Dan Allen
Principal Software Engineer, Red Hat | Author of Seam in Action
Registered Linux User #231597

http://www.google.com/profiles/dan.j.allen#about
http://mojavelinux.com
http://mojavelinux.com/seaminaction
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-as7-dev/attachments/20110706/702ec0ba/attachment.html