Mailing List Archive: 49091 messages
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search

[REBOL] Re: Documentation: Let's do it NOW!

From: lmecir:mbox:vol:cz at: 10-Aug-2003 10:29

Hi all,
> Gregg: > > Sunanda has been working on the new > > submission pieces (you can submit scripts now, but we have to do > > things manually, and the goal is to automate everything so there's no > > delay waiting for us to get involved). > > Not just me, Gregg and Volker too as the core library team -- and Robert > Muench is chipping in a chopped Make-Doc-Pro for Library documentation. > > I hope we'll have something to show within a month. The improvements we
> cooking up will make the Library more interactive, and scripts will be
able to
> have: > > ** documentation -- you'll be able to add a script *and* the user manual
> "How I wrote this" article or whatever attached to the script. That should > make scripts easier to use, and make the library more of a place to browse
> inspiration and REBOL knowledge, rather than just bare scripts.
this functionality (documentation) has been already achieved at the R.E.P site ( ). It contains bug data some of us have written, documentation to some of our scripts, features of Rebol and more. It is a pity that the library team tries to duplicate the functionality.
> ** discussion -- anyone can start a discussion thread about a script -- to > request new functions, report errors, suggest improvements etc. You could
> some of the recent discussion about XML parsing hanging off an XML script, > leading to the final version in the Library being the distillation of many > people's comments.
This is a functionality already present at the R.E.P. site too.
> ** ownership -- the owner(s) of a script can update it, or the
> or moderate the discussion thread hanging from it, without having to go > through the slow, manual, contribution process we have now.
At the R.E.P. site not just the owner, but everyone can update the documentation, enhance it etc. I suggest everyone to try to write at least one piece of information there.
> We've got a fair bit of backroom work to do to enable that, so when I say
> hope we'll have something to show in a month, I don't mean everything. But
> are whittling away at the outstanding coding tasks. > > I'd like to see the Script Library as a nexus for anyone who cares about > quality REBOL scripts to contribute scripts or ideas or notes. That will
make it a
> very valuable resource for new people learning REBOL. > > None of that replaces the ideas discussed in this thread about a > documentation wiki and other mechanisms. But I think those ideas fit in
well with what we
> have planned.
The documentation wiki idea looks like yet another forking in this area. Did Robert have a look at the R.E.P. site?
> There's quite a bit of new code in place already on the offline test
> If any one fancies a spot of system testing to help us iron out the bugs,
> you have a web-server installed locally on your computer -- please drop me
> email. > > Thanks! > Sunanda