Rant Re Rev Documentation

[Judy Perry]

Well, how about it, folks?

Judy

On Sun, 24 Jul 2005, Timothy Miller wrote:

> Maybe someday, many dictionary terms could be linked with mini-stacks
> that actually demonstrate the use of the command, property, function,
> object or whatever described in the documentation. These could be
> downloaded by the user at need, or downloaded all in an archive, for
> local retrieval by the documentation stack, as needed. (I assume the
> onboard documentation is a stack.) The mini-stacks could be donated
> by Rev-loyal users.

<snip>
>
> I just can't understand why Rev hasn't done all of these things
> already. It might be a somewhat daunting task, but it's minuscule
> compared to the trouble it took to build Rev in the first place. If
> it's too much for Rev's overworked staff, they could get 95% of the
> work done for free. All of the items I've mentioned could be
> submitted by users to a wiki. Of course, Rev would need editorial
> control of the wiki to keep out errors and vandalism. Even the
> editorial control of the wiki could be delegated to experienced and
> responsible volunteer users, who could check each other's work, and
> so on. Professional developers could be allowed to place
> self-promotional links in their wiki contributions.