Hello! I'm in effort to make Pd documentation better. To map what we need to do, I'm starting to ask Pd community. So you can help responding 2 questions:

1. What is the audience that you believe will make use of the Pd documentation? Things like, advanced english speakers, academics, the gender, low/high earning power, if they are programmers, musicians, open source people, nationality... whatever you can write in a few words.
2. Issues you see in actual way to document the objects, suggestions to improve documentation to meet your imagined pd user.

Educational experiences, examples of documentation patterns, opinions about how things have been done so far are welcome!

If you want to contribute more in effort to improve Pd Docs Structure I have opened a issue in Pd github:

https://github.com/pure-data/pure-data/issues/1320

@Nicolas-Danet I neutralized your downvote.

@Jona Thanks. I'll sleep better tonight.

It's funny how people don't just assume they can help and contribute to Pd's documentation. I don't know where that comes from, really.

@Nicolas-Danet said:

Was just something about < https://docs.github.com/en/organizations >, an usual approach to manage collaboration with various levels. Oh i've been downvoted.

ok, I got it wrong then, so upvoted now but I still don't know what you mean by creating a new repository without interacting with the core team, this link did not clarify it to me. Is the idea then to create something and then merge back into upstream? Why not a fork then?

And I also don't get why you're quoting me saying I don't get why people feel there's something preventing them from collaborating to the documentation. I've never seen PRs like that getting rejected, I've written a new section on the manual, many help files, so if you have something to add to the discussion, please share.

@porres First page not first result. For your same search and no history I get the floss site for the 4th, on duckduckgo it is the 3rd, the first result which is not puredata.info on both. So a good number of people are clicking that link. I would say the Floss manual is aimed at a different audience, those who want analog style sequencers instead of markov chains. It serves a different purpose than the manual.

yeah, I contributed to it in 2009 and there are some cool things there, I'm not sure exactly what to do with it, but I have a new thread https://forum.pdpatchrepo.info/topic/13479/pd-floss-manual-what-to-do-with-it

@porres For instance on my fork i put all the tutorials outside of the software repository < https://github.com/Spaghettis >. I created an organization that owns all the stuff. And thus i could give easily the rights for anybody to work on those tutorials, without to care to add noise into the main development. I could even give push rights for an user (that have no idea about C/C++) without fears (for me and him/her/it) to make something wrong. In my case i don't have time to spend in large debates, and such with that approach i would quickly give/split responsabilities to avoid to blow my head. Anyway that is only speculations, since in my case i have zero user, and in your case as you said:

Pd Vanilla is developed and maintained by one person: Miller Puckette.

Something like that < https://github.com/pure-data/pddp >?

@Nicolas-Danet said:

Something like that < https://github.com/pure-data/pddp >?

yeah, I see it now, IOhannes has just proposed the same thing, see https://github.com/pure-data/pure-data/issues/1333#issuecomment-851315723

we're on it

The PDDP repository is... pure. A very very pure solution. No content, thus no issues. Awesome!
Is somebody know what is it supposed to be? That: https://puredata.info/downloads/pddp?

@Nicolas-Danet PDDP was the complete Vanilla help within Pd Extended (I mentioned it above).
It contained style sheets and hyperlinks....... basically what you are all looking at accomplishing now..... but already done for Vanilla (within the Extended download) in about 2012.
That is why I suggested tweaking it for the latest Vanilla.
There was far more "help" within it than the current Vanilla help.

If you download Pd Extended......... https://puredata.info/downloads/pd-extended it is certainly contained within the source code (the tarball I think).
No idea why it has been deleted from its dedicated puredata.info page.
I have often recommended that people grab it when they are stuck..... it is very helpful.

Once you have the source code uncompressed just do a search for PDDP.
That will list all the Vanilla help files in the doc folder and the pddp folder that contains the files necessary to set it up as a service on a server.
David.

@60hz I'm late to this thread but I only wanted to say that your help files look completely amazing, particularly your help-intro.pd! I've taught Pd in a lot of different ways and I can absolutely see that being extremely helpful to new users. well done!
this is a very wide-ranging discussion, but it's great to see a vision of an approach to some of these issues.

@yannseznec
Thanks a lot! I mixed and modified the work of many people for the interface, and I regulary make change to many help patches and it works better and better with students (I use a top down logic). I hope one day pd will be easier to learn and I won't need this anymore