<div dir="ltr"><div dir="ltr">Em sáb., 2 de jan. de 2021 às 22:20, David Rush <<a href="mailto:kumoyuki@gmail.com">kumoyuki@gmail.com</a>> escreveu:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>4 - Where can I get the nice help templates used by Else/Cyclone &cet? <br></div><div>        Everything I've found online seems to be both massively out of date</div><div>        and expects that you already know how to use it.</div></div></blockquote><div><br></div><div>As the one who worked on the help files of the two libraries you cited, I can say I don't really know :) haha...</div><div><br></div><div>Ok, more seriously, I just did it based on stuff that was out there before. I guess you mentioned the pddp templates? See <a href="https://puredata.info/dev/pddp/DraftReferenceDesigns">https://puredata.info/dev/pddp/DraftReferenceDesigns</a> - is that what you are calling outdated? </div><div><br></div><div>Anyway Cyclone 0.2 had this template I'm not sure exactly where it came from, and I just made some variations on it. You can check PD-l2ork's help structure, I guess it came from there... see "all_about_help_patches.pd".</div><div><br></div><div>Now, there are some common practices you can get inspired from but no strict rules or golden standard on how to structure your help file... and I'm not really happy with what I have and eventually I could change it a bit...</div><div><br></div><div>What I can tell you is that making a good documentation file is hard, takes a lot of time and thought and that it is usually neglected in the Pd world. I cry every time I open a patch with a big mesh of wires all over the place and over messages/objects... sometimes I can't even sleep. Just try to make things clean!!! And document all the messages! Organize it in subpatches if there's too much. </div><div><br></div><div>cheers</div></div></div>