Printable View
Just taking an informal survey here - when you see code in a book, would you rather see a couple of pages of code then the explanation for the whole thing or a chunk along with it's explanation? Another possiblity - if the code is a class what would you think about all of the members of the class and their explanation, then the class functions and their explanation. Or some other totally different layout. What works best for you?
Chunks of code are pretty boring, in my opinion. Thats what the CD is for :D. Id rather see just the relevent snippets, and an explaination. More then likely, ill just read the explaination, and refer to the code if i want to see how they implemented it.
Z.
Are you making a book??? For me this works best.
- First explanation of what the code is supposed to do.
- Then The code with normal VB comments.
- Then more in detail what each part of the code does. Like difficult lines of code. And explanation of keywords and so on...
About classes I would probably prefer the same thing as above...
PS: And remember to never use slang or try to make your English difficult. That’s really irritating for me and probably everybody else that speak an other language daily...