Praise: Rev Documentation to the rescue

[Thomas McGrath III]

Jon,

But that is exactly the point. WHO will do this work and WHERE should 
it be put and in What context. Rev has been slowly making the docs 
better and it is still a work in progress. They are also trying the 
online conference thing with attached sample stacks (which is great). 
But this amount of work will definitely interfere with bug fixes and 
enhancement requests at the present time. They have started to 
implement a user editable area in the docs for user contribution on 
specific doc items but it still needs work.

Where as a WIKI would be nice but people have already tried that and 
stalled in the effort. Besides a WIKI on some ones website besides Revs 
is not a good idea in the long run since that person might move or die 
or whatever and the effort is then lost. So Who, What and Where are the 
critical issues if this is to ever get done. It needs to be always 
accessible and monitored and formatted for correctness let alone be 
updated as changes are made to Transcript.

Don't get me wrong I would love to see these:
1.) Extra examples in the existing docs (from different points of view 
- with different possible usages)   .
2.) Sample stacks with existing code to make these examples work.
3.) A truly 'for beginners only' tutorial for the Rev application and 
interface and lastly
4.) A series of working Concept stacks that show the most integral 
parts of Transcript and how it can be used.

Personally, I would like to see RevOnline expanded to host strictly 
pre-formated user submitted solution stacks that have gone through 
REV's seal of approval and hosted there and accessible from within Rev 
itself. This would be different from the user area where the strictness 
would not exist since many times that is to share a work in progress 
and get feedback. The format could be 'very' close to the format used 
in the online conference stacks.

So if enough volunteers are available to write/contribute to these 
pre-formated stacks AND Rev is agreeable to host the space and provide 
the links in the RevOnline area then we could start to work on what 
types of solution/ideas are needed the most at this time. Then people 
could start working on them and this might get done. Other wise it 
becomes all 'talk'.

Yours,

Tom

On Jul 25, 2005, at 9:37 PM, Jon wrote:

> Whether this belongs in the "docs" or in something else is beside the 
> point.  If I'm struggling with how to use a REPEAT, I need examples.


Macintosh PowerBook G-4 OSX 10.3.9, OS 9.2.2, 1.25 GHz, 512MB RAM, Rev 
2.6


Advanced Media Group
Eagle Works Art & Sculpture
Semantic Compaction Systems
Prentke Romich Company
Prentke Romich International
SCIconics, LLC
Artist
Thomas J McGrath III
3mcgrath at adelphia.net