Re: Part 1 of beginner's course written

Hi Chris,

Just thought I'd mention this, it's been bugging me for a while:

Why is "Summary" being used as the first topic on every page? IMHO as a
tech writer, a "Summary" topic belongs at end of a document, with an
"Overview" or "Introduction" topic at the start. A CMS problem maybe?

You may considered this a trite point, but users who are not native English
speakers may have difficulty understanding why this is occurring at the
beginning instead of at the end of the doc's content.

Kind regards,

Frank M. Palinkas
Senior Technical Writer
Quixey, Inc., Mountain View, California
Mobile: +1 650 248 5315
Web Accessibility and Standards tutorials:
http://dev.opera.com/author/947856


On Mon, Apr 15, 2013 at 11:28 AM, Chris Mills <cmills@opera.com> wrote:

> Hi all,
>
> Today I've put together a first draft of the beginner's course:
>
> http://docs.webplatform.org/wiki/beginners/the_beginning
>
> Let me know what you think. Does the language hit the mark for complete
> beginners? Is this too much theory up front? The next Part dives straight
> into practical coding, and I've tried to keep this as short as possible.
>
>
> Chris Mills
> Opera Software, dev.opera.com
> W3C Fellow, web education and webplatform.org
> Author of "Practical CSS3: Develop and Design" (http://goo.gl/AKf9M)
>
>
>

Received on Monday, 15 April 2013 18:57:30 UTC