Another hopefully extensible suggestion: larger libraries with a cohesive purpose should get a standard boilerplate message saying something like "Cyclone is a library for creating Max compatible patches. The closest pd-native equivalent of this object is [until]." or "GEM is a library for 3D graphics. For an overview of GEM, see <here>". The Cyclone example is sort of an extension of the "deprecated by" suggestion: in general, it would be nice to direct users to the "right object".
<div><br class="webkit-block-placeholder"></div><div>Luke<br><div><div><br class="webkit-block-placeholder"></div><div><br><div><span class="gmail_quote">On 10/1/07, <b class="gmail_sendername">Luke Iannini (pd)</b> <<a href="mailto:lukexipd@gmail.com">
lukexipd@gmail.com</a>> wrote:</span><blockquote class="gmail_quote" style="margin:0;margin-left:0.8ex;border-left:1px #ccc solid;padding-left:1ex"><div>Hey, this is really cool! Great work! I am committed to contributing as much as I can.
</div><div><br> </div>It would be great to take a really well known object and do a "reference article" to somewhat establish quality standards for the articles, and give lazy editors a template to work from when cleaning up the dumped text.
<div><br> </div><div>A "see also"/"related" section would be great, like [append]: see also: [list]. (maybe the categories take care of this)</div><div><br>
</div><div>Also, a standard for writing "deprecated by" would be really helpful for old objects.</div><div><br> </div><div>big cheers</div><div><span class="sg">Luke</span><div><span class="e" id="q_1155ed236d530d4c_2">
<br><div><br><div><span class="gmail_quote">
On 10/1/07, <b class="gmail_sendername">Hans-Christoph Steiner</b> <<a href="mailto:hans@eds.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">hans@eds.org</a>> wrote:</span><blockquote class="gmail_quote" style="margin:0;margin-left:0.8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>Yay!!<br><br>Everyone dump your content into it, it is a ready recepticle!<br><br>:D<br><br>.hc<br><br>On Oct 1, 2007, at 8:54 PM, marius schebella wrote:<br><br>> hey,<br>><br>> pdpedia is online!<br>><br>
> It is a child of the second pdconv in montreal and many people helped<br>> putting it up, hans and I finally did the import of the objects and<br>> the<br>> main layout for the site. I hope you will like it.
<br>> At the moment we still use the address <a href="http://wiki.puredata.info" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">http://wiki.puredata.info</a>,<br>> but it<br>> should be <a href="http://www.pdpedia.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
www.pdpedia.org</a> in the next days/weeks. (at the moment
<br>> <a href="http://pdpedia.org" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">pdpedia.org</a> is linked to a test site...)<br>> The general idea of the project is to have better documentation of Pd,
<br>> mainly - but not only - its objectclasses. I hope it will become a
<br>> useful tool to search for objects and ways how to do things in Pd. the<br>> search field should really work as a "how do I..."<br>> all objects have some basic information like a short description,
<br>> library, categories, ... but we also dumped text that we found in the<br>> helppatches to give a little help for filling in content. that is the<br>> goal, to get many people involved in sharing knowledge about how to
<br>> use<br>> the objects, document features, and so on.<br>> at the moment we are running without authorization, everybody can edit<br>> and create pages (a wiki page is created by putting two brackets<br>> around
<br>> a word like [[this]] then you click on that link and can edit the new<br>> page...). If we get in troubles with spam we will have to restrict<br>> editing only for registered users, but everybody can register, feel
<br>> free<br>> to create an account.<br>> if you see links like Template:blablabla in the beginning: that is a<br>> global wiki variable. we use it for all information that is<br>> presented on<br>> more than one page. for example the URL for a library. just fill in
<br>> the<br>> content of the variable and it will show up on all pages.<br>> I don't want to write to much, so I stop, plese send feedback.<br>><br>> marius.<br>><br>> ps: and yes, there are some bugs still.
<br>><br>> _______________________________________________<br>> <a href="mailto:PD-list@iem.at" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">PD-list@iem.at</a> mailing list<br>> UNSUBSCRIBE and account-management ->
<a href="http://lists.puredata.info/" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
http://lists.puredata.info/</a><br>> listinfo/pd-list<br><br><br><br>------------------------------------------------------------------------<br>----<br><br>Man has survived hitherto because he was too ignorant to know how to
<br>realize his wishes. Now that he can realize them, he must either<br>change them, or perish. -William Carlos Williams<br><br><br><br><br>_______________________________________________<br><a href="mailto:PD-list@iem.at" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
PD-list@iem.at</a> mailing list<br>UNSUBSCRIBE and account-management -> <a href="http://lists.puredata.info" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">http://lists.puredata.info</a>/listinfo/pd-list
<br></blockquote></div><br></div></span></div></div>
</blockquote></div><br> </div></div></div>