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 <<a href="mailto:david.bain@alteroo.com">david.bain@alteroo.com</a>> 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 <<a href="mailto:kamon.ayeva@gmail.com" target="_blank">kamon.ayeva@gmail.com</a>> 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 <<a href="mailto:kevin@bud.ca" target="_blank">kevin@bud.ca</a>> 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) [or Get Started]<br>
<br>
• Installation<br>
• "Beginner" Tutorial (this is a direct link to the Tutorial in the "Reference Manual")<br>
• Releases<br>
• Download or get Grok from svn<br>
• Grok extensions<br>
</blockquote>
<br></div>
Note that "Installation" and "Download" have quite a bit of overlap between them. Anytime I approach a project I am unfamiliar with, I look for "download" first - I would guess the trend is for most people to look for a "download" link first? From the download page one gets presented with the necessary install instructions (since you don'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>
• "Beginner" Tutorial (direct link to the Tutorial in the "Reference Manual")<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>
• "Beginner" Tutorial (this is a direct link to the Tutorial in the "Reference Manual")<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 '<a href="http://phc_grok.pt" target="_blank">phc_grok.pt</a>' template to suit the new/improved navigation (feel free to just rip out the topic-based listing stuff if it's undesirable). We can't use the same Navigation portlet as the rest of the site, since that Portlet just displays content as it'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'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>