Amiga5k wrote:As documentations go, PB's is not the worst I've seen (BlitzMax's is really bad...), but may just need to be re-organized a bit with lots (at least one for every command) of example code. Tutorials are very helpful, too, and many more should be included in the standard distribution, IMHO.
Yes, you're right. Adding an example for (nearly) every command is hardly needed. But it's also a huge work...
Amiga5k wrote:Using a "I've never used ANY programming languages" approach in a "User Guide" can help get the user up and running, while the Reference Manual would delve deeper into the how's and why's of the commands. It's an approach that I've always found most useful.
This is just that, what german community is already doing. Take a look on german site of
PureWiki and you will see a chapter 0 (beginning with programming in general and then continues with programming in PB).
Amiga5k wrote:The only "problem" I have with the wiki is that you would have to be online to read it (although a stand alone version could be created on a periodic basis - say every few months or so).
Of course it's planned to offer an offline edition of the PureWiki on a regular basis. Even more - useful additions should also find their way in original PB documentation.
