<br><div class="gmail_quote"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><br>
As an end goal, I&#39;d like us to extend and refactor the &quot;Manipulating Plone Objects Programmatically&quot; tutorial[1] into a more hierarchically structured reference manual that covers the most common tasks. Some tasks may require references to other tutorials (e.g. the Archetypes tutorial), but at least it&#39;s a starting point and a place to collate future APIs as well.<br>

<br>
The current groupings and lists of APIs can be found here:<br>
<br>
  <a href="http://www.mindmeister.com/maps/show/21419197" target="_blank">http://www.mindmeister.com/maps/show/21419197</a></blockquote><div><br>Is it just my, but I can&#39;t get the link open even after registering myself to mindmeister (gives me my dashboard page)? <br>
<br>In any case here is the old discussion from docs list from while ago:<br><br><a href="http://www.openplans.org/projects/plone-documentation/list-of-manuals">http://www.openplans.org/projects/plone-documentation/list-of-manuals</a><br>
<br>Note that API does not only include Python API, but all templates and CSS classes are basically undocumented. There already exist javadocs like CSS documentation frameworks. But as long as it takes &lt;tal:comment replace=&quot;nothing&quot;&gt; &lt;/tal:comment&gt; overhead to write a comment in TAL we have little hope that anyone could ever bother to write comments there.<br>
<br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><a href="http://www.mindmeister.com/maps/show/21419197" target="_blank"></a><br>
 - any APIs that you use regularly that are not captured</blockquote><div> <br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> 
- any APIs that you use regularly that you hate (whether on the list or not)</blockquote><div><br>PloneTestCase has too less functionality out of the box and you have to reinvent the functionality for every test case/product - also it has tons of partially documented boiler plate code which is very fragile and does not give meaningful error results.<br>
<br>PTC could have functions e.g. for:<br><br>- Automatic product/package/layer/whatever initialization without boilerplate<br><br> - MailHost mocking<br><br>- Sane error output for functional tests<br><br>- Security testing (test code executed under RestrictedPython) <br>
<br>Hope this inspires thoughts. <br></div><div><br>&gt; Missing APIs...<br><br>How to register and manipulate Z3 registeries (adapters, subscribers, viewlets, views) from Python in Plone context. Five/site awarness/etc. adds extra complexity for this and Zope 3 documents cannot be applied for Plone as is. Basically all can be done with magic multi adapter queries as long as you would know the parameter list and the right site(?) to call.<br>
<br>-Mikko <br></div></div><br>