I am reporting http://drupal.org/node/1056742 to moderators because:

please unlock, so i can add to the Requirements: external library

CommentFileSizeAuthor
#5 Drupal-Community-Documentation-navigation.gif61.83 KBsirtet

Comments

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Status: Active » Fixed

Page is unlocked.

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented

When you edit the page, you might consider also changing the page title from "Installation" to something that would stand alone, such as "Installing FullCalendar". It is very confusing when pages with generic non-specific titles like "Installation" come up on drupal.org or Google search results.

sirtet’s picture

sirtet
Primary language German
Location Switzerland
commented

I did change the title too.
Yes, this confused me too and i was wondering if it said just "Installing" on purpose. But i did not dare to jam another question into the same issue...
Thanks for reading my mind :-).

In addition, i was also confused by the tabs "Community Docs Home", "Installation Guide", "Administration Guide".
I think, having the book-navigation (in this case "‹ FullCalendar up Usage ›") on top too, would clarify a lot and make bad titles less problematic. Easy to implement too i guess?

I saw New navigation for d.o community docs, but did not really read it, maybe this idea belongs there?

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented

We can't really add yet another layer of tabs to the navigation at the top of Drupal.org. There is already a bunch of stuff there... The book-level navigation is only shown on the right sidebar, and we're discussing updates to it on that issue you found.

Sorry about that. :)

By the way, if you want to go change the page titles on the other FullCalendar pages, please do so. :)

sirtet’s picture

sirtet
Primary language German
Location Switzerland
commented
StatusFileSize
new Drupal-Community-Documentation-navigation.gif61.83 KB

Done with the updating, thanks for unlocking.

But i am not sure if this is totally right, repeating the parent-page's title may lead to complicated titles sometimes...
I imagine a breadcrumb or so could help, or, to some extent, the book-style navigation that i mentioned above, not sure if i got misunderstood there, so i added an image here.
this prev-up-next navigation seems a well known meme, seen it in quite a lot of different places before, and normally, it repeats on top and bottom.
cloning the Book-style navigation to top

If you are headed in a different way, never mind... sure there are even better ways, just wanted to make sure i got understood.

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented

The breadcrumb idea is a good one. I'll add it to an issue we have for discussing improvements to Docs navigation:
#1289090: [meta] Improve search/navigation for d.o community docs

But we still do need page titles that can stand alone. The reason is search results. When you search on Drupal.org or Google or whatever, the page title is the link you see as the header for each item. So it needs to be complete enough to tell you what kind of a page you are getting.

So if I see a page title like "Installation" in search results, I might think it's Drupal installation, and this one is just installation for a particular module.

sirtet’s picture

sirtet
Primary language German
Location Switzerland
commented

Would it maybe help to somehow compose the displayed title form the actual title, and the book's parent pages titles?

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented

Maybe, but that is not how we are doing things now, and our current docs standards are that titles should stand alone.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.