[kde-doc-english] Doc team website

[Jessica Hall]

On Thu, 28 Jul 2005 00:15, Lauri Watts wrote:
> Front Page
> ==========
> * The *first* thing on the docs page should be something like "Want to join
> the docs team? Here's a simple <n>-step guide".  
> * Ideally <n> is very small, and includes "please contact the doc team"
> very early in the list.
> * We also noted that we might want to emphasise "Do you want to contribute
> to KDE" over "join the docs team".  Or not, this is something to discuss. *
> General decluttering.  Shorter texts, turn the front page into more of a
> roadmap where everything is, rather than trying to jam things onto it. *
> Write a very brief mission statement, to emphasise we are not scary
> monsters, we are here to _help_ you get started.

One thing to watch with using 'contribute to KDE' instead of 'Join the docs 
team' ... I'm sure everyone on this list has heard from someone at least once 
that  'Documentation is what you can do if you're not good enough to be a 
programmer' and I'd love to open the site with strong paragraphs focusing on 
technical writing as a highly specialised skill, not something you can fall 
back on if you're not a very good coder. I really want to eradicate this 
'Well if you're no good at anything else you can always write docs!' attitude 
that many people outside of the docs team seem to have =)

Regards,
-- 
JH

KDE Frequently Asked Questions:
http://docs.kde.org/development/en/kdebase/faq/index.html

panic("esp_handle: current_SC == penguin within interrupt!");