Hi all,<br><br>Just to update you that Uli and I have just filed tickets for the tasks needed to be done on the website/docs improvement.<br><br><a href="https://bugs.launchpad.net/grok-web/+bugs">https://bugs.launchpad.net/grok-web/+bugs</a><br>
<br>I am volunteering to help on these first tasks in the coming weeks.<br><br>Cheers,<br>Kamon<br><br><br><div class="gmail_quote">On Fri, May 2, 2008 at 1:02 PM, David Bain &lt;<a href="mailto:david.bain@alteroo.com">david.bain@alteroo.com</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;">+1 on the proposed revisions to the website.<br><br><div class="gmail_quote"><div><div></div>
<div class="Wj3C7c">On Fri, May 2, 2008 at 2:34 AM, Kamon Ayeva &lt;<a href="mailto:kamon.ayeva@gmail.com" target="_blank">kamon.ayeva@gmail.com</a>&gt; wrote:<br></div></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div><div></div><div class="Wj3C7c">
<br><br><div class="gmail_quote"><div>On Fri, May 2, 2008 at 3:40 AM, Kevin Teague &lt;<a href="mailto:kevin@bud.ca" target="_blank">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><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>


</div></blockquote></div><div><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<div><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></div><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></div><br>Thanks for this information.<br><font color="#888888"><br><br>-- Kamon<br>
</font><br></div></div>_______________________________________________<br>
Grok-dev mailing list<br>
<a href="mailto:Grok-dev@zope.org" target="_blank">Grok-dev@zope.org</a><br>
<a href="http://mail.zope.org/mailman/listinfo/grok-dev" target="_blank">http://mail.zope.org/mailman/listinfo/grok-dev</a><br>
<br></blockquote></div><br>
<br>_______________________________________________<br>
Grok-dev mailing list<br>
<a href="mailto:Grok-dev@zope.org">Grok-dev@zope.org</a><br>
<a href="http://mail.zope.org/mailman/listinfo/grok-dev" target="_blank">http://mail.zope.org/mailman/listinfo/grok-dev</a><br>
<br></blockquote></div><br>