Hello all,<br><br>At the Grokkerdam sprint, Fred and I have looked at the current site structure to see how it could be improved and incorporate the new Reference generated from the Grok subversion tree (thanks to the work done by Uli).<br>
<br>To start, we are proposing the following navigation:<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><br>This is a new section we propose to add, and which should come first, to get people started with Grok.<br><br>2) About Grok<br><br>• Why Grok ?<br>
• Features<br>• Component Architecture<br>• Projects using Grok<br>• Who is Grok ?<br><br>This is already existing. We just need to improve its content a bit, and maybe add the "Projects using Grok" page.<br><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>3) Community<br><br>• Grok Mailing Lists & Forums<br>
• IRC Channel / IRC Channel Log<br>• Grok Wiki<br>• Issue tracker<br><br>We would keep this existing part unchanged.<br><br>These changes could be done step by step with some planning and after checking they do not conflict with other changes/plans.<br>
So your comments are welcome.<br><br>-- Fred & Kamon<br><br>