[Tinyos-devel] tutorials on docs.tinyos.net wiki (was: Tinyos2.x on Mac)

[Matt Welsh]

I don't care particularly which markup language is used, but I do want  
the doc WG to use a wiki model where pages can be edited  
"online" (rather than requiring someone to download the source, edit  
it separately, then manually publish it). I don't know anything about  
reST or MoinMoin so would appreciate input on the issue.



On Dec 16, 2007, at 6:36 PM, Vlado Handziski wrote:

> I am a bit concerned about the proliferation of different source  
> formats in the TinyOS documentation. The TEP files are reST, the  
> original tutorials were directly composed in HTML and now we have a  
> MediaWiki for the doc WG that forces us to use yet another markup. I  
> believe we have been very happy with the reST. Now when things are  
> in flux, maybe it is a good time to check if there is a way to  
> consolidate the different source formats for the different types of  
> documentation. Does the documentation WG insist on using the  
> MediaWiki engine and markup? If we move to MoinMoin  (used by the  
> Core WG)  we can use reST format for the tutorials also....
>
> Vlado
>
> On Dec 16, 2007 8:47 PM, Kevin Klues <klueska at gmail.com> wrote:
> The problem is that the tutorials on the wiki aren't complete yet.   
> Most of them were just created using an html->wiki converter that  
> didn't import any images and left some links external when they  
> really should have been internal.  I agree though, once these  
> tutorials are cleaned up, the link to the old ones should redirect  
> you to the wiki site.  This is actually what I did with the MAC  
> installation tutorial, but some people had apparently created  
> bookmarks directly to the google documents page where I created it,  
> rather than the masked address I used to redirect you there.  I've  
> now just deleted the tutorial completely and put a reference to  
> where the new one can be found in the contents of that page.
>
> Kevin
>
>
> On Dec 16, 2007 9:04 AM, John Griessen <john at ecosensory.com> wrote:
> Kevin Klues wrote:
> > Al of these error you mention are addressed in the updated version  
> of the
> > tutorial you refernced that is now part of the tinyos  
> documentation wiki at
> > docs.tinyos.net.  I should take down the old one so as not to  
> confuse people
> > I guess..... either that or update it as well.
>
> The wiki is working easily to add new documentation as the urge  
> strikes to write it, and the old
> tutorials set in the repository are going to be out of date now.
>
> Back when I wanted to
> get the word out about a platform creation tutorial and code that  
> helps debug new
> platform circuit boards, that tutorials were part of the repository  
> hindered me.
> I just published "a version" of the code tree tutorials page on my  
> web server.
>
> I suggest deleting the tutorials from tinyos-2.x now, and stopping  
> serving them from
> tinyos.net/tinyos-2.x/doc/html/tutorial.
>
> John Griessen
>
> --
> Ecosensory   Austin TX
> tinyOS devel on:  ubuntu Linux;   tinyOS v2.0.2;   telosb ecosens1
> _______________________________________________
> Tinyos-devel mailing list
> Tinyos-devel at millennium.berkeley.edu
> https://www.millennium.berkeley.edu/cgi-bin/mailman/listinfo/tinyos-devel
>
>
>
> -- 
> ~Kevin
> _______________________________________________
> Tinyos-devel mailing list
> Tinyos-devel at millennium.berkeley.edu
> https://www.millennium.berkeley.edu/cgi-bin/mailman/listinfo/tinyos-devel
>
>
> _______________________________________________
> Tinyos-devel mailing list
> Tinyos-devel at millennium.berkeley.edu
> https://www.millennium.berkeley.edu/cgi-bin/mailman/listinfo/tinyos-devel