[PD] Patterns for Pd Documentation

[Dan Wilcox]

Does anyone have a link, etc to the pddoc project/external from Pd-extended? I feel a lot of this was already approached over 10 years ago but not ported over into Pd vanilla. It might be worth checking it out before starting from scratch.

Also, keep in mind that old habits may be hard to break so don't be surprised if enforcing "one pattern to rule them all" might become "whack-a-mole."

> On May 25, 2021, at 1:50 AM, pd-list-request at lists.iem.at wrote:
> 
> Date: Mon, 24 May 2021 20:49:37 -0300
> From: Esteban Viveros <emviveros at gmail.com <mailto:emviveros at gmail.com>>
> To: Pd-List <pd-list at lists.iem.at <mailto:pd-list at lists.iem.at>>
> Subject: [PD] Patterns for Pd Documentation
> Message-ID:
> 	<CAJQqjJRsQWxirbgOhr3kTT2q9Qydf5t9kSOU6QRJ-mB3yiokfQ at mail.gmail.com <mailto:CAJQqjJRsQWxirbgOhr3kTT2q9Qydf5t9kSOU6QRJ-mB3yiokfQ at mail.gmail.com>>
> Content-Type: text/plain; charset="utf-8"
> 
> Hello list! I'm looking for beliefs, judgment, advice, and anything that
> can contribute to better documentation of the entire world for pd users
> only.
> 
> I suggest explicit 2 points:
> 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: Pattern design for Pd Documentation
> <https://github.com/pure-data/pure-data/issues/1320 <https://github.com/pure-data/pure-data/issues/1320>>
> 
> Thanks for all! :)

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.puredata.info/pipermail/pd-list/attachments/20210525/0d87fd8f/attachment-0001.htm>