Hi Joep, It looks excellent from the balance perspective of text versus images. I think one of the best places for publishing is scribd http://www.scribd.com/ and of course in the jallib pack.
However, some things I'm thinking about: - first time when appears in text abbreviations must be fully explained, this is a rule of good practice. JalApi for instance is the same thing with Jal Application Interface or not? - page 16: "on the right is shown a 16x2 character display with a 16x1pin connector". the user may not understand what is 16x2 and why has only a 16x1 connector...Be sure a software guy which has previously written software for PC don't. - I believe you will upgrade the footnotes like 13 (15, 21) when the tutorial will grow, pointing tho that chapter explaining arrays. With this idea, you should number the figures and refer in text as " As in fig.1" instead "on the right" because someday you will need to refer in chapter two to a particular image from the first chapter. As well " the schematics below" from page 19 is in fact " the schematic on the right" and should be better if will be "in the fig.5" - in footnote 14 you discourage the user for understanding deeply the library "so better do not use them in your application" is the worse version of " use them in your application when you fully understand how to do it" because a clever user is not bounded with a library. Use affirmative sentences as many times you can. - external links form the tutorial may not work if the user's acrobat reader is not properly configured, that's why links should be easily copied and pasted in a browser in manual mode. From this perspective links should stay in one row only. In fact, a rule of good practice put the links in the reference section (at the end of a page, chapter or book) using internal document cross linked within the referenced sentence ( [1] with a cross link to the external link where the reference stay) - in page 19 you refer to "TTL level (5V)" as a 5V logic level which is more 5V CMOS than TTL compatible. I didn't see where you explain clearly that VCC is +5V and VSS is the return path of VCC, except indirectly in page12 referring to the button connection. - I felt that writing the PWM you've lost your energy because you've did not point that PWM is the most powerfull D2A converter feature and as well the biggest noisy generator from a PIC. - hopefully writing the language features, your energy comes back to you, however you have mixed references with footnotes. 18 is a reference and not a footnote. A foot note is used for explaining directly something which you decide to not do it in text. A reference is another paper/html link/etc with informations which has been used by yourself when writing or programming. One question: instead of exhibit wouldn't be better appendix or addendum? Sorry for bothering you again, Vasile On Sat, Mar 20, 2010 at 11:43 PM, Joep Suijs <[email protected]> wrote: > Hi guys, > > Enclosed version0.99a of the starters guide. All of your feedback is > considered and much is incorporated, like a full schematic diagram, > created by Wayne. > Please let me knwo if there are changes required before this docuent > becomes version 1.0 and what would be a good place to publish this > document. > > Joep > > -- > You received this message because you are subscribed to the Google Groups > "jallib" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]<jallib%[email protected]> > . > For more options, visit this group at > http://groups.google.com/group/jallib?hl=en. > > -- You received this message because you are subscribed to the Google Groups "jallib" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/jallib?hl=en.
