Personally, I feel the migration document (from berts Starter Pack) should be independent of the Introductory manual of jalv2 and jallib. If that is the case, there needs no mention of Bert's starter pack in the Introduction Guide. Also Wouter's Start With Pics and mikroPascal help files can be used as good reference material in creating the docs.
I also would suggest to have circuit diagrams when examples are described. In page 6 of the manual there's a small mistake, "So you we use ‘led’, we could have used" does not make sense. The writing style and overall looks are pretty impressive. But IMHO the language reference guide should come out first, things like _usec_delay could easily be referenced then. Sunish On Sun, Aug 16, 2009 at 4:30 PM, Joep Suijs <[email protected]> wrote: > Hi all, > > We discussed the need of introduction documentation for jallib/jalv2 > on the jallib list. Toon and I made quite some progress on this > subject and since there are similar initiatives on the jalweb list, I > decided to release an early version of the result for review. Please > tell us what you think of this. > > And as for all these initiatives: I think we should have a plan first > on what we need, how we get this and how we mainitain it. Creating > something is easy. Creating something usefull for a broader audiance > is a difficult, since it has to have a suitable form, needs to be > correct and complete (and it would be good to have an introduction and > advanced documentation / reference for the next level). The real hard > thing is to maintain what is created. And this is also the most > important one, otherwise there will be an other dead resource on the > subject, making it more difficult to achieve a decent result in the > future. > > IMHO, the document enclosed could wel become the introduction guide. > It covers most of the subjects, except the language introduction, > hardware and programming (ICSP, bootloader that is). > The exended guide could be based the pjal documentation (which seems > to be ignored, except by sunish) and info from the api documentation > as a reference. The result will be documents, not a flashy site or > colorfull blog. Is that what we want to invest in? If so, we need a > few people contributing and someone who takes the rol of chief > editor... > > 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] For more options, visit this group at http://groups.google.com/group/jallib?hl=en -~----------~----~----~----~------~----~------~--~---
