[Tinyos-devel] Broken links i TEP docs

[Vlado Handziski]

On 9/26/06, Philip Levis <pal at cs.stanford.edu> wrote:
>
> On Sep 25, 2006, at 1:47 PM, Martin Leopold wrote:
>
> > Hi All.
> > Reading through some of the TEP's I noticed that a bunch of the
> > links to
> > other TEP's are broken. For example tep103 refers to:
> >    "tinyos.net/working_groups/tinyos-2.0wg/teps/"
> >   (which does not exist anymore)
> >
> > Others refer to cvs.sourceforge.net (that doesn't work) or
> > tinyos.cvs.sourceforge.net (that does work).
> >
> > I don't know if there is a consensus on the current location of the
> > TEPs, but even so wouldn't it make sense to update the links to a
> > consistent location that works (at least for now)?
>
> Thanks for this catch.
>
> The reason why there are these inconsistencies has been due to our
> moving things around to enable people to see both the most current
> versions *and* the versions associated with a TinyOS release.
>
> I'll bring this up at the WG meetings this week, and make a general
> call for people to update accordingly. Hopefully there will be a
> consistent story by the end of the week.



The best long term solution to this problem is the introduction of new
docutils macro for TEP cross-referencing. The base url will then become a
configuration parameter that can be passed to the modified rst2html script
that knows how to handle the new macro. This is the way PEPs
cross-referencing works. But it will require our own tep2html scrip (which
is trivial to do, we just need to subclass and modify 2 classes). If there
is an interest for this I can do the changes, and we can put the tep2html
script on CVS (it will still require having docutils installed).

Vlado
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.millennium.berkeley.edu/pipermail/tinyos-devel/attachments/20060926/4a98a280/attachment.htm