Hi guys, I understand Joep wants to keep control over the document (for now if I understand). But I hope it'll be opensource (and there are opensource license you can use for this purpose). As Matt said, I hope the time will come when we'll be able to DITAfied it to include it in all the process. We may provide one book, or two different books, I don't have strong opinion as long as there are independent.
About samples, there are some specific used with the tutorial book. This code remains in a "dita/.../.../code" directory. Joep, you could do the same (in the future, when DITAfied :)). Cheers, Seb 2010/2/25 mattschinkel <[email protected]> > > > Each tutorial takes the user by there hand assuming that they did the > > > "getting started". > > > > I have to agree with you Matt, the Tutorials are taking the user by the > > hand, the same way Bert's Book did. The problem, as I see it, is that > > the Tutorials are doing things to show how an application that the > > Tutorial writers are interested in. That's why I didn't learn much from > > Bert's book. I had no interest in 'any' of the projects it covered. > > The startersguide that I saw before had some specific applications > such as PWM which a reader may not be interested in. It is the same. > > Hopefully our tutorial book will have a great range of tutorials, and > everyone will be interested in at least one topic. All new users will > be interested in getting started. It is not about "tutorials the > writers are interested in". I am actually not interested in servo's, > but I see many people who are, so I created a lib and I will later > create a tutorial. I believe servo's are a hot topic. It is fun to do > things like this for others. > > > On the other hand I found the first Tutorial by Joep and Toon very > > educational. It covered the language use in accomplishing a 'task' not > > a useless, to me, project. That might just be me though. > > The tutorial book is "step-by-step" in the beginning (getting started - > > blink a led -> serial port), as it should be, these are topics all > new users should be interested in. If your step-by-step method is > better then ours, we can replace it or create a new chapter. One of my > idea's for the tutorial book was to create tasks/homework for the user > so they may get experience, but I have not had time to implement this. > > I am simply suggesting one completed book with "starter guide" + > "Tutorials". > > > I'm sorry if I offended anyone. That is not my intent. > You do not offend anyone with your words, honesty is needed and > appreciated. I may offend others at times although I do not mean to, I > just state my thoughts. If we are all honest with eachother, we will > be happier about the final product. > > Matt. > > -- > 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. > > -- Sébastien Lelong http://www.sirloon.net http://sirbot.org -- 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.
