<br><br><div class="gmail_quote">On Fri, May 2, 2008 at 3:40 AM, Kevin Teague &lt;<a href="mailto:kevin@bud.ca">kevin@bud.ca</a>&gt; wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div class="Ih2E3d"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<br>
<br>
1) Get Grok(ked) &nbsp;[or Get Started]<br>
<br>
• Installation<br>
• &quot;Beginner&quot; Tutorial (this is a direct link to the Tutorial in the &quot;Reference Manual&quot;)<br>
• Releases<br>
• Download or get Grok from svn<br>
• Grok extensions<br>
</blockquote>
<br></div>
Note that &quot;Installation&quot; and &quot;Download&quot; have quite a bit of overlap between them. Anytime I approach a project I am unfamiliar with, I look for &quot;download&quot; first - I would guess the trend is for most people to look for a &quot;download&quot; link first? From the download page one gets presented with the necessary install instructions (since you don&#39;t actually want to download Grok, but instead run grokproject and let buildout do the downloading ...).<div class="Ih2E3d">
</div></blockquote><div class="Ih2E3d"><br>Ok. I buy that.<br>So we get less links, like:<br><br>
• Download (page will include details on the different ways of installing, including svn)<br>
• &quot;Beginner&quot; Tutorial (direct link to the Tutorial in the &quot;Reference Manual&quot;)<br>
• Gok releases<br>
• Grok extensions<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<br>
3) Documentation<br>
<br>
• &quot;Beginner&quot; Tutorial (this is a direct link to the Tutorial in the &quot;Reference Manual&quot;)<br>
• Refence Manual (this links to HTML generated using Sphinx on the server)<br>
• Howtos (PHC)<br>
• Tutorials (PHC)<br>
<br>
This is a reorganization of the current documentation section to include a link to the Reference (static html structure) that is going to be generated from Subversion,<br>
as well as user-contributed howtos and tutorials. (Also see the other mail from Fred regarding the reference documentation workflow.)<br>
We also think that the overview menu generated from the PHC - when you are in the current PHC - should be removed from the left column because it is very long and confusing.<br>
<br>
</blockquote>
<br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Hosting the offical grok docs (reference, tutorial, notes) as static sphinx docs is easy enough. The PHC overview menu will need to be adjusted to accomodate it - if you have a working buildout of the grok web site for developing on, you can modify the gzo.plonesmashtheme package (<a href="http://svn.zope.org/gzo.plonesmashtheme/" target="_blank">http://svn.zope.org/gzo.plonesmashtheme/</a>)<br>

<br>
gzo/plonesmashtheme/portlets/grokdoc.py and <a href="http://phc_grok.pt" target="_blank">phc_grok.pt</a> make up the Documentation portlet that gets presented on the web site. You can modify the existing &#39;<a href="http://phc_grok.pt" target="_blank">phc_grok.pt</a>&#39; template to suit the new/improved navigation (feel free to just rip out the topic-based listing stuff if it&#39;s undesirable). We can&#39;t use the same Navigation portlet as the rest of the site, since that Portlet just displays content as it&#39;s structured within Plone. But if you put mirror the top level navigation elements statically in the documentation-navigation portlet that should be fine, it&#39;s not like we are changing the top-level navigation very often.<br>

<br>
You can also modify gzo/plonesmashtheme/browser/<a href="http://dochome.pt" target="_blank">dochome.pt</a> which is the documentation home page template to reflect the new documentation structure.<br>
<br>
</blockquote></div><br>Thanks for this information.<br><br><br>-- Kamon<br>