I have to teach in the end of the month, it will be a nice opportunity to proof read this before, and collaborate with the feedback you want. GOOD JOB! cheers
On Thu, Apr 9, 2009 at 1:40 PM, Derek Holzer <de...@umatic.nl> wrote: > Dear list, > > the book sprint for the Pd FLOSS Manual last weekend went very well! Several > writers and proofreaders joined us at each location in New York City and > Berlin, as well as remote contributors online (see contributors below). > > The good news is that quite a lot of content was generated over the weekend, > including the beginnings of entirely new sections on GEM, MIDI, Network Data > and Sensors. You can see the work-in-progress FLOSS Manual via the editing > interface here: > > http://en.flossmanuals.net/bin/view/PureData/WebHome > > The not-so-good news is that most of these new sections are in limbo! Next > month, Adam and I hope to publish version 1.0 of the Pure Data FLOSS Manual > to the front page of the FLOSS Manuals site for public viewing: > > http://en.flossmanuals.net/ > > The chapters that will be included in Version 1.0 will be: > > INTRODUCTION > INSTALLING > GETTING STARTED > THE INTERFACE > AUDIO TUTORIALS > DATAFLOW TUTORIALS > STREAMING > LIST OF OBJECTS > APPENDICES > > But in order to do this, some of the chapters in each section need some > improvement. Here's what needs to happen immediately. Please take a look and > see if you can help! > > ____ALL CHAPTERS____ > --Proofreading for spelling, simplicity, new-user-friendliness and > consistent tone (see INSTALLING, GETTING STARTED, THE INTERFACE and AUDIO > TUTORIALS chapters for style and format examples). > > ____AUDIO TUTORIALS___ > > -> This section is almost done. What remains is to make a proper tutorial > out of it... i.e. that the examples in the chapter follow a "story" which > leads up the construction of a simple synthesizer. Due to changes in > structure of the chapters inside, this needs updating, but I will work on > it. > -> In general, structure, tone and content of these chapters should serve as > guide for the rest of the manual. > -> I would like to see all sections follow this tutorial model, of building > up a project from the various elements introduced in each chapter. > -> keep in mind that other sections (such as MIDI, NETWORK DATA, SENSORS, > etc) can build on examples started in this chapter, so that the whole manual > is interconnected and has a proper "storyline". > > * http://en.flossmanuals.net/bin/view/PureData/Tables > --where does this go? Dataflow or Audio? (Audio I think) > --Would be good to integrate with > http://en.flossmanuals.net/bin/view/PureData/ArraysGraphsTables > --I'd like to crop screenshots to get rid of menu bar > --Incomplete, needs expansion and also "loop it" and "play sections" parts > --Could this also be structured like tutorial rather than taxonomy? > > ____DATAFLOW____ > > * http://en.flossmanuals.net/bin/view/PureData/Messages > --Looks very good! > > * http://en.flossmanuals.net/bin/view/PureData/Math > --"I guess it isn't necessary to explain how [+], [-], [*] and [/] work. " > Check for tone. > --Bit twiddling: empty > --Expr: empty > --Audio math: empty > > * http://en.flossmanuals.net/bin/view/PureData/Lists > --Needs more than taxonomy, i.e. real world examples!!!!! > > * http://en.flossmanuals.net/bin/view/PureData/OrderOfOperations > --Needs a little attention, but I'm not sure, maybe simpler examples, > clearer screenshots, explain object abbreviations in-line if used > > * http://en.flossmanuals.net/bin/view/PureData/WirelessConnections > --Examples too busy, need to be simpler!!!!!! > --Text doesn't really connect to examples > > * Subpatches, Abstractions & Dollarsigns > --These should all be in one chapter, explaining how to make reusable > patches with nice interfaces, rather than atomized into different > chapters(title = Patch Management?) > > * http://en.flossmanuals.net/bin/view/PureData/Subpatches > --Needs final real world example, maybe in connection with abstractions + > GoP > > * http://en.flossmanuals.net/bin/view/PureData/Abstractions > --Tie in with Patch Management (to be created) > --Better examples! > > * http://en.flossmanuals.net/bin/view/PureData/DollarSigns > --Get rid of this chapter, confusing collision with dollar signs in messages > --Better examples, explained in-line in text > --Tie in with Patch Management (to be created) > --All examples are not saved anywhere!!!!! > > * http://en.flossmanuals.net/bin/view/PureData/GraphOnParent > --Move to Patch Management (to be created) > --Not completely explained (colored background canvas) > --No colors in Pd patch screenshots please! > > * http://en.flossmanuals.net/bin/view/PureData/ArraysGraphsTables > --Check text for clarity, accuracy, simplicity > --Redo screenshots with antialiased text please! > > ___LIST OF OBJECTS____ > -> Table format doesn't work in some browsers (Adam Hyde will look into > this) > > ____GLOSSARY____ > -> HTML tables don't work well here, Adam Hyde will reformat text with <h1>, > <h2> and <h3 tags> > > > > ...and finally, THE CONTRIBUTORS! > > Here are the folks that helped us rock last weekend, in no particular order: > > AdamHyde > DerekHolzer > HansChristophSteiner > ScottFitzgerald > VincentRioux > PatrickDavison > JoaoPais > ServandoBarreiro > KorayTahiroglu > MariusSchebella > JeremySchaller > MaxNeupert > EvanRaskob > GeorgWerner > AlexandrePorres > JayMaechtlen > RomanHaefeli > DanielShiffman > LauraGarciaBarrio > AlejoDuque > > (My apologies if I accidentally left someone out!) > > Thanks all, I'm looking forward to seeing this 1.0 version looking its best! > Derek > > -- > ::: derek holzer ::: http://blog.myspace.com/macumbista ::: > http://www.vimeo.com/macumbista ::: > ---Oblique Strategy # 123: > "Once the search has begun, something will be found" > > _______________________________________________ > Pd-announce mailing list > pd-annou...@iem.at > http://lists.puredata.info/listinfo/pd-announce > -- Alexandre Torres Porres cel. (11)8179-6226 Website: http://porres.googlepages.com/home http://www.myspace.com/alexandretorresporres _______________________________________________ Pd-list@iem.at mailing list UNSUBSCRIBE and account-management -> http://lists.puredata.info/listinfo/pd-list