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

[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.