[ Thread Index |
Date Index
| More lists.tuxfamily.org/slitaz Archives
]
- To: slitaz@xxxxxxxxxxxxxxxxxxx
- Subject: Re: Documentation Sprint
- From: Rohit Joshi <rj.rohit@xxxxxxxxx>
- Date: Tue, 20 Apr 2010 12:56:27 -0400
- Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:received:message-id:subject:from:to:content-type; bh=5JZ0S8nGyOLpVrUn+MQ7HijV0uXwF5WHBiIVbadyZQY=; b=m3UdUg5p0gJJTgw7DR078gAm4XkPAtPXhexImi5TJVurIXdA4RAhhJ0CLdmuKT1m5w MpNH7eAFxMGvkA401uZxOiDxfHnst8ynHz6udh68PE86gfCpOKzUfjleHPV0QMOJ77p7 tqOJ6wBd1no2aPE3Y/SlTyZfBXQ/B8WUrSGLY=
- Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; b=LJay8VeuAajLiEKlRWa3K+kkM9tvJc806i4V1qAlrg1pNf/UKdJzxIzmse4VOZVWAQ BYfFducQDeUwYPccVfmZxI+kFBpdxtI32QHkAey4rMsNdObHA10AEMYE0okByHZLr0Nv ynUUwfCajfm4SbtLVUWm1AkQIu2KA+izoEiTY=
Hi Ben,
+1 for the idea. Yeah, get the ball rolling before the world cup fever
grips everyone :-)
Rohit
On Tue, Apr 20, 2010 at 5:18 AM, Ben Arnold <iamseawolf@xxxxxxxxx> wrote:
> Hi all --
>
> I read an article yesterday that asked where the "Summer of
> Documentation" was (1). As if mind-reading, @jpeg recently posted (2)
> that the hand / cook book hasn't really been brought up-to-date with
> the release of v3. I propose we organise a period of time this summer,
> say a fortnight, where a group of us focus on the SliTaz documentation
> to ensure it is of as high quality as the distro itself. This sprint
> can be done be the community, without needing developers to track
> issues and bug-fixes raised, as is the case in providing support on the
> forum.
>
> I reckon we can get the ball rolling by identifying the most
> important, or most visible, pages to update first, as suggested by
> @jpeg. Things like Xorg & hardware set-up spring immediately to mind,
> as they've changed dramatically recently with kernel & software
> updates. Those will probably need a bit more work than others that
> call only for reading and checking. A 'junior jobs' list could be
> created to encourage time-constrained/newer users to contribute. A
> "this page has been confirmed correct!" box at the head of each page
> could it has been reviewed.
>
> We could follow this by expanding on the testing process, as discussed
> a little while ago. Hopefully issues may be identified though the docs
> sprint and make drafting a testing process easier. It could be argued
> that guides should be tested by a few users rather than the process of
> one; utilities or extra software may be present on the author's
> computer but not by default etc. etc.. v4 would then see a tested
> package process and clean, confirmed docs.
>
> What do you guys think?
>
> Ben
>
> - - - - -
> 1: http://2tu.us/202h
> 2: http://ur1.ca/vxxc
>
> --
>
> Ben Arnold
> Chester, UK
>
> e: ben at seawolfsanctuary.com
> w: seawolfsanctuary.com | t: @seawolf
>
> nom = { :cookies => :mouth }
> nom; nom; nom
>
---
SliTaz GNU/Linux Mailing list - http://www.slitaz.org/