[Grok-dev] Re: [website] Let's do content!

Martijn Faassen faassen at startifact.com
Thu Jan 3 14:43:13 EST 2008


Kevin Teague wrote:

> How-To:
>   Single page of documentation.
>   Typically associated with goal-oriented tasks, although I've named this
> "Mini Tutorial" for the time being in keeping with the old site.

I never liked "mini tutorial" as our current mini-tutorials aren't all 
tutorials. Some are just sketchy notes. Let's go for 'howto'.

> Tutorial:
>   Multi-section documentation.
>   For lengthier, more in-depth subjects on a particular topic, but a reader
> should still be able to digest an entire Tutorial in one sitting.
> Reference Manual:
>   Multi-chapter, multi-section documentation.
>   For large works. I suspect that we may want to publish the main Grok
> Tutorial here as a Reference Manual, since it is already organized into
> Chapters/Sections. Which means we might want to rename the content-type on
> the site to something like "Book"?

I support "Book" for the tutorial. I hope to work some more on this 
book. Eventually I hope we make it into a paper book.



More information about the Grok-dev mailing list