wiki reorg - Documentation Team

[Michael Shiloh]

Josh Monson wrote:
> Thank you very much for the direct Response Stroller :)
> 
> I think this is a great idea and addresses my question 100%. I did not
> see this previously and apologize. 
> 
> So that leaves me with....where are we at with this? I have been swamped
> at work and have not had much time to peruse the site in the past 3
> days. 
> 
> Are we moving fwd w/ this idea? 
> 
> -----Original Message-----
> From: Stroller [mailto:stroller at stellar.eclipse.co.uk] 
> Sent: Thursday, July 24, 2008 6:52 PM
> To: Josh Monson; documentation openmoko
> Subject: Re: wiki reorg - Documentation Team
> 
> 
> On 24 Jul 2008, at 23:46, Josh Monson wrote:
>> ...
>> So at this point, I guess my question would be of the following...Say
>> it's been a few days since you have been able to check this lists
>> emails, and you find yourself w/ a few hours of free time, or time you
>> would like to dedicate to the wiki. How would one quickly find out
>> something you could edit or organize that would be productive?  
>> Email the
>> list and wait for a response? Go to the wiki page and just find
>> something you feel should be different? Etc.....
> 
> My proposal for TODO / FIXME templates would address this. You could  
> simply look at the "TODO" category and see every page in need of  
> work. Perhaps we should add a "in need of updating" category? That  
> would be more general and better for outdated pages than those which  
> have a specific line or paragraph which needs addressing.
> 
> I addressed both these questions in this post:
> http://lists.openmoko.org/pipermail/documentation/2008-July/000033.html
> 
> I would be grateful if you were to reply to that, even if it were to  
> say "naw, this is a stupid idea". (But as I see it my suggestions DO  
> address your proposals).
> 
> Stroller.


(I usually follow the style of the previous emailer to decide whether to 
top post or bottom post, but since the main body is from Stroller I'll 
follow his lead and bottom post)

I've not heard anything official from Brenda or Will, so until they 
correct me I'll speak for the company:

What Stroller and Josh say is exactly what I have in mind, and we are 
thrilled that you volunteers are taking this on.

Long-term, I'd like to see some thought given to a consistent 
documentation style, perhaps a template (or three: one each for wiki, 
web page, printed documentation).

I'm going to visit the TODO category and see if some of my pet peeves 
are there :-)

Michael