[drupal-docs] Drupal navigation tutorial

[Kieran Lal]

You bust you ass for weeks.  Reading your lousy tutorial over an over  
again hoping to make it better, but all the time realizing that you are  
too close to it see what's wrong with it.

All you ask for is a little obvious criticism.

And it makes every thing worthwhile.

Thanks Richard.

Kieran
On Mar 24, 2005, at 3:46 PM, Richard Eriksson wrote:

> On Thu, 24 Mar 2005 13:16:31 -0800, Kieran Lal
> <kieran at civicspacelabs.org> wrote:
>> http://beta.civicspacelabs.org/home/navigationtutorial
>
> If I understand it correctly, this document is going to be part of
> documentation packaged with CivicSpace?  Hence the direct links to
> administration pages?  If not, then the paths to getting to the
> administration pages would need to be spelled out.  Some brief notes
> about each page (I just clicked "next" as I went along reading it).
>
> http://beta.civicspacelabs.org/home/node/8885 could use links for each
> individual item in case the reader wants to skip ahead
>
> http://beta.civicspacelabs.org/home/node/8883 it's a little hard to
> 'read'.  Do users who are about to follow a tutorial get a lot out of
> a flow chart?
>
> http://beta.civicspacelabs.org/home/UsefulNavigation this might be
> better suited as an appendix?
>
> http://beta.civicspacelabs.org/home/node/8875 should be page two.  I
> love the short descriptions of Drupal terminology we power-users take
> for granted (I hear Boris' voice echoing in my head, saying "the
> glossary module would be perfect for this").
>
> http://beta.civicspacelabs.org/home/node/8876 could possibly use
> screenshots of the sites linked at the bottom.
>
> http://beta.civicspacelabs.org/home/node/8877 might be better suited
> as an appendix, linked from
> http://beta.civicspacelabs.org/home/node/8875
>
> http://beta.civicspacelabs.org/home/node/8886 ditto
>
> http://beta.civicspacelabs.org/home/node/8878 7 clicks to get to the
> first how-to instructions is 5 too many.  This would work well as the
> third page.
>
> http://beta.civicspacelabs.org/home/node/8888 the items in the list
> could use links if users want to skip directly to the instructions
>
> http://beta.civicspacelabs.org/home/node/8891http:// 
> beta.civicspacelabs.org/home/node/8893
> and http://beta.civicspacelabs.org/home/node/8880 are step-by-step, so
> should probably have an ordered (numbered) list rather than an
> unordered (bulletted) list.
>
> http://beta.civicspacelabs.org/home/node/8892 could maybe use some
> step-by-step elaboration of the points in the unordered list
>
> http://beta.civicspacelabs.org/home/node/8894 (has "Create menu items"
> repeated?)
>
> You might benefit from the text and/or ideas at
> http://support.bryght.com/adminguide/how-to/dynamic-web20-brochure- 
> site-in-an-hour
> written by Roland Tanglao.  That is, if I understand the bits
> encouraging creating some 'static' navigation pages correctly.
> There's definitely a need for a 'best-practice' on creating a
> navigation structure for different types of sites using Drupal
> distributions, and Kieran, your tutorial is a step forward. :)
>
> -- 
> Richard Eriksson
> Bryght Community Support
> http://support.bryght.com/
> -- 
> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]
>