[documentation] URGENT: Please review upgrade
tutorial instructions
Charlie Lowe
cel4145 at cyberdash.com
Thu Dec 1 14:52:13 UTC 2005
Kieran Lal wrote:
> Which duplicate links? You mean duplicate because this is a book, and
> we have child pages that are the same? I would rather do this as pages
> because I don't think book navigation is that good for jumping around
> in a tutorial like this. If I get page permission I redo them as pages
> not book pages. What do others think? Look how it is done at
> http://civicspacelabs.org/upgrade
I think this might be the problem you have here. The original
organizational structure was not designed around using the book
navigation links. You've designed it around the idea that "I would
rather do this as pages." Right now, when I quickly scan the Intro to
upgrading page, I see a mass of links that is not very scannable. As a
user, I feel like I would need to figure out why there are two sets of
links and why there are "continue to" and "jump to" options.
So I agree with Kobus's comment from later on "Exactly. This is overkill
and makes it look like it is not planned properly." This page is very
messy.
More information about the documentation
mailing list