Brian Keller asked for suggestions on the VS .NET help in An Intense Lunch.
At first I thought he was joking about "Stone's Way" series - no only did some one write it, but it taking up disk space on my machine. I assume its already destined for the trash bin.
Useful suggestions:
- Many of the sample program fragments in the docs don't include output. It is pain to fire up a separate copy of VS .NET, build a project, ... - just to figure out what the output is. Even snippet compiler can be a hassle. There should even be graphical output to demo the graphical stuff. If there differences between one method and the next is only subtle then the output can be even more important.
- Some enums and methods just parrot back the enum/method name and a few simple words. Please give us enough detail to understand what they do. For example PenType.HatchFill and PenType.TextureFill - there are no examples of these in the docs or in Petzold.
- Ensure all of the permissions especially link demand permissions are well documented. I've discovered a few (that I've reported), when I got a security exception in the default internet permission set.
Thats all for now - I will post more as I find them