[Tinyos-alliance] TInyOS Documentation Working Group chatter

[David E. Culler]

Matt,
  The discussion at the last alliance call was completely supportive, 
but  you were going to update the charter and the participation 
guidelines.  In particular, we were protecting this group from taking on 
all the front-page tinyos.net issue.  We talked through dividing that 
into panes so we can distribute the efforts.

D.

Matt Welsh wrote:
> 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...
>