So true Gregory. Michael
On Oct 3, 2010, at 12:16 PM, Gregory Lypny wrote: > But the documentation problem, both with the user guide and built-in help or > dictionary, goes far beyond updating. Good writing, examples, organization, > and consistency in design take time. If you type the word Array into the > built-in help, the only hits you will get is for ArrayEncode and ArrayDecode > but nothing for an array itself. Someone new to LiveCode, who perhaps > coincidentally got far enough into the user guide to come across arrays, > would be hard-pressed to get any information about their uses or properties. > A benchmark for good documentation in my mind is the original HyperCard User > Guide and HyperCard Reference Manual. The writing is clean and the example > code statements and handler snippets are carefully chosen to give the fullest > scope of usage of the item in question. Another is Mathematica's built-in > documentation (and even their online documentation), where what they lack in > Apple's writing and publishing suave, they make up for in comprehensiveness. > My recommendation for the Rev team would be to spend less time on rebranding > and promotional splash screens and more polishing the software _______________________________________________ use-revolution mailing list use-revolution@lists.runrev.com Please visit this url to subscribe, unsubscribe and manage your subscription preferences: http://lists.runrev.com/mailman/listinfo/use-revolution
