Re: Summer of Documentation: preparing to announce

[Ben Arnold <iamseawolf@xxxxxxxxx>]

Hi -- sorry I haven't followed this up until now, been rather busy!


> How about having this documentation sprint (as suggested by Ben)
> for 1 month from May 10-June 10 (World Cup begins June 11th :-) )
> ? I think we are all ready.

I was hoping for a little longer as I have four university exams in 
the next three weeks. Thankfully, I've gotten a solid amount of work 
done on a professional project so can mostly leave that for a short 
while. I think a post on the forum might drum up some support; I'll 
post on my identica/Twitter, personal blog and Community page about it 
(again). I do wonder how many active forum posters are on this mailing 
list...

How about this week concentrating on getting the guidelines etc. 
sorted?


> We are expecting that everyone will add, edit and update wiki
> pages. Some new guides have been created as a starting reference
> point : http://doc.slitaz.org/en:guides:start
> 
> If its successful, we can make it an annual / biannual event :-)

Sounds great! A Summer is but once a year :)

I think it should be certainly each major distro release. (Hopefully, 
as the packages and processes are updated, the doc page for it will be 
to... something that will be included in the Testing stuff, I'll make 
sure of it!)


> We need to update, review and centralize our documentation. Read
> this page for activities to-do list and general guidelines :
> http://doc.slitaz.org/guidelines .
> 
> I need your help in reviewing and editing the instructions on the
> guidelines page. Once they are approved, we make a formal announce
> on the website and the forums.

Looks good. I'm just looking through it to maybe clarify some points. 
One hing that does spring to mind: there are different types of pages 
(FAQ differs to Guides, which both differ to Contribution guides etc.) 
so I'll draft up a set for each I can identify. It would balance 
consistency with relevance... kind of a customised consistency.


Thanks for your efforts, Rohit -- let's get the word out there!

Ben

-- 

Ben Arnold
Chester, UK

e: ben at seawolfsanctuary.com
w: seawolfsanctuary.com | t: @seawolf

nom = { :cookies => :mouth }
nom; nom; nom

Attachment: signature.asc
Description: This is a digitally signed message part.