[REBOL] Re: docs for facets styles for vid?
From: carl:cybercraft at: 12-Sep-2009 11:02
On Friday, 11-September-2009 at 9:18:28 David den Haring wrote,
> Another common response to this question is "Just study the source". Good,
>comprehensive documentation is hard to write. You take it for granted until
>it's not available.
But when it's a commercial product, it's the job of those who produced it to provide
the docs for how to use it. It's also terribly inefficient to leave it to others to first
figure out how it works and then explain it. Those who designed it already know how it
works and why it works as it does, (hopefully), so they're the obvious ones to write
the docs. They'll be able to do it quicker and better than hundreds or thousands of users
all studying the source in the hope of figuring out how things work, most of who'll give
up before getting much of a grasp of how it works.
REBOL's supposed to be a better, quicker way to program. But how much time have its users
lost because the View/VID docs were only half done X number of years back and then left
at that stage?
-- Carl Read.