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

[Vlado Handziski]

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
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: https://www.millennium.berkeley.edu/pipermail/tinyos-devel/attachments/20071217/28d9a059/attachment.html