[Tinyos-alliance] TInyOS Documentation Working Group chatter

[Matt Welsh]

Keep in mind I am still waiting for formal approval of the TinyOS Doc  
WG.

On Oct 5, 2007, at 4:30 PM, Michael Schippling wrote:

> All really good suggestions. How do we go about implementing?
>
> I haven't yet gotten a feeling of there being much Working or Group
> in this TosWG yet. I believe we have a Commander in Chief, but I
> forget who it is...so I repeat my question:
>
> Do we have an agenda, proposed agenda, motion to create an agenda?
> Is there a process in place, or what?
>
> MS
>
>
> Ákos Maróy wrote:
>> Michael Schippling wrote:
>>> I'm all for a wiki, and to my surprise there is one:
>>> http://cents.cs.berkeley.edu/tinywiki/index.php/ 
>>> TinyOS_Documentation_Wiki
>>> however it seems to be very sparsely populated.
>> wow, excellent!
>> but, is the link available anywhere? :) does it come up when you  
>> google for "TinyOS wiki"? or "TinyOS documentation"? Or TinyOS in  
>> general?
>> (the answer to all the above questions is no)
>> the biggest problem is actually that registration is not open on  
>> this wiki. on the http://cents.cs.berkeley.edu/tinywiki/index.php? 
>> title=Special:Userlogin page you get:
>> Contact smotemanager at millennium.berkeley.edu to request an  
>> account.
>> people are not going to contribute if it is difficult to do so.
>>> The problem is in getting the right people to contribute, and then
>>> monitoring the results, much like wikipedia. But at least we don't
>>> (yet) have politicians and corporations "fixing" their online  
>>> records.
>> :) the way to get people to contriube is bigger exposure by far.  
>> really.
>>> So...what are we actually doing in this Documentation WG? Do we
>>> have an agenda, proposed agenda, motion to create an agenda, or  
>>> what?
>> my suggestion to get the wiki rolling is:
>> first and foremost: enable registration on the wiki site!
>> then:
>> - move the wiki to the domain: http://wiki.tinyos.net/ or http:// 
>> docs.tinyos.net/
>> - advertise the wiki on the tinyos.net page, big, so people see it
>> - list the wiki big on the support page: http://tinyos.net/scoop/ 
>> special/support
>> - move the FAQ over to the wiki: http://www.tinyos.net/faq.html or  
>> at least mention the wiki on the FAQ
>> - put a note on the mailing list descriptions for people to check  
>> the wiki first before asking questions, here http://tinyos.net/ 
>> scoop/special/support#mailing-lists
>> - put the wiki link into the signature of the tinyos-help mailing  
>> list, also mentioning to extend the wiki with answers they get to  
>> their questions on the list
>> Akos
>> PS: this all takes just too long - actually I was thinking about  
>> installing a new MediaWiki myself under http://tinyos-wiki.tyrell.hu/
>> like we've been ping-pong-ing around this issue for months now...