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: SunandaDH::aol::com at: 8-Aug-2003 13:42

> 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 are 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 or 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 for inspiration and REBOL knowledge, rather than just bare scripts. ** discussion -- anyone can start a discussion thread about a script -- to request new functions, report errors, suggest improvements etc. You could image 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. ** ownership -- the owner(s) of a script can update it, or the documentation, or moderate the discussion thread hanging from it, without having to go through the slow, manual, contribution process we have now. We've got a fair bit of backroom work to do to enable that, so when I say I hope we'll have something to show in a month, I don't mean everything. But we 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. There's quite a bit of new code in place already on the offline test system. If any one fancies a spot of system testing to help us iron out the bugs, and you have a web-server installed locally on your computer -- please drop me an email. Thanks! Sunanda