dagcrack wrote:PB rockz, and for those that trashed it cause of a lack of docs, they should shot their balls right now.
Yeah, ok, whatever you say new kid on the block.
I've been programming off and on since 81, from peeking and poking assembler opcodes as integers on an Apple II as we didn't have Applesaoft and the mini-assembler, to Pascal, some Forth, Pilot, C, etc.
PB is an outstanding product.
However, I had our copy dept. print me a copy of the 3.72 docs, and find them to be dificult at best, relatively speaking. Some of them appear to have been updated with examples, such as pg. 275 OpenFileRequester(). Nice.
The latest 3.80 docs may be better, however since I can't d/l them, I would gather they are mostly the same, from my browsing the online docs.
You may be some uber-coder, however the average audience I though PB was targeted at is somewhere in the normal distribution. That being so, I think the documentation is key to attracting new people. A well laid out primer/text should be viewed as a Good Thing(tm). IIRC, the current PB documentation is pretty similar to that which I saw in my Amiga reference books almost 20 years ago... If the PB community really wants to grow and expand, then there has to be effort expended in making more comprehensive documentation with much better examples.
I'm surprised there aren't a couple of simple tutorials on making Windowed apps at the least. I've had a couple of people help me out here and there, and it is greatly appreciated. Not everyone is familiar with event driven windows programming.
If you want to be some l33t fanbio hAx0r/C0d3r, be my guest.
But, to truely become better, one has to take off the rose colored glasses occasionally and reassess strengths and weaknesses.
Currently, PB is weak in documentation. Not that there aren't a number of people putting a lot of personal time in, in creating docs, tutorials, web sites, etc. To those people and Fred, I say thank you. I'm looking forward to the continuing efforts on both the code and documentation side.
To the fanbois who can't see the bigger picture, I feel sorry. Cause I've seen the same thing happen many times, the Amiga community is a particularly sad example of such.