[PD] Pd FLOSS Manual, what to do with it?

ol at ogeem.be ol at ogeem.be
Tue Jun 1 14:45:35 CEST 2021


concerning the french version :

I was part of it back in 2011, and still have access,
the organisation that manage the french FLOSS manuals and actively 
organized booksprints to write them is still active also ( 
https://activdesign.eu/ )

at the time, given the context and potential public for the book (which 
is also available on paper) we did a complete rewrite of the manual, 
including context history and explanation of use case so newcomers in 
the "creative interactive media creation" could jump in.

the french manual while proposing (at the time) to install pd-extended 
for beginners, does not make a hard choice and is focusing on the basis 
of the tool, talking about the different libraries independently of the 
way it has been installed (namely GEM, PDP, Pduino, OSC) in a 
progressive manner (compared to the english one which is more a 
technical reference) as we also took into account the fact that each 
object has a help patch. (which should be translated somewhere ... ?)

it is indeed outdated for the installation parts (and it's mention of 
pd-extended that should be replaced by an article about deken) but still 
mostly relevant for the most part (I still use it to teach the basics)

Like for the articles on Wikipedia, I'm not sure there need to have 1/1 
correspondence between languages ... but maybe the english one could 
take inspiration on the french one for it's structure

this is quite a job to make a revision and translate it, not sure when I 
could put time on it, but it's indeed time we look at it again 
collectively ;)



> there's also yet another link here which seems to refer to the same 
> content
> of the new incarnation of the manual
> http://write.flossmanuals.net/pure-data/introduction2/
> why? dear god, why?
> Em seg., 31 de mai. de 2021 ?s 18:07, Alexandre Torres Porres <
> porres at gmail.com> escreveu:
>> Em seg., 31 de mai. de 2021 ?s 07:35, Dan Wilcox 
>> <danomatika at gmail.com>
>> escreveu:
>>> I agree. I think the current Pd-extended focused manual could be 
>>> moved to
>>> a Pd-extended location for historical reasons.
>> what's a "pd-extended location" and where is it?
>>> The "main" Pd FLOSS manual should be Vanilla + links or sections to
>>> active forks including the original Pd-extended manual. The current 
>>> manual
>>> could then be refactored/updated and existing links would not be 
>>> *terribly*
>>> broken.
>> It has now come to my attention that we have different versions of 
>> this
>> manual. There's an archived version =>
>> http://archive.flossmanuals.net/pure-data/
>> And a new version created two months ago by 'mickfuzz' which is 
>> actually
>> the same! https://en.flossmanuals.net/pure-data - The Pd Vanila html
>> manual references to this link, by the way, and also to a french 
>> version
>> here:  https://fr.flossmanuals.net/puredata/introduction/
>> Note that the french version is considerably different, so yeah, we 
>> have
>> quite some chaos... there are two versions somehow, different and
>> independent unofficial takes on what a Pd manual is and should be and
>> depending on what language you speak you get a different idea and
>> information? :)
>> Well, I'd love to help sort things out, but I don't know where to 
>> start,
>> it's all decentralized in a very messy way.
>> We need to coordinate the efforts if anything is to be done. I speak 
>> no
>> french, for instance
>> Where are the floss manuals people anyway? Who is 'mickfuzz'? Who's
>> working on the french version?
>> How could I get involved in the english one?
>> Thanks

More information about the Pd-list mailing list