Project

General

Profile

Actions

Bug #5211

closed

[Documentation] Top Navbar of docs homepage not suitable for small window

Added by Nancy Ouyang about 9 years ago. Updated about 9 years ago.

Status:
Resolved
Priority:
Normal
Assigned To:
Category:
Documentation
Target version:
Story points:
0.5

Files

docnavwrap.png (36.6 KB) docnavwrap.png Nancy Ouyang, 02/13/2015 06:29 PM

Subtasks 1 (0 open1 closed)

Task #5441: review 5211-improved-top-navbarResolvedWard Vandewege02/13/2015Actions

Related issues

Related to Arvados - Feature #5493: [Workbench] Add "Getting Started" modal inside WorkbenchResolvedRadhika Chippada03/30/2015Actions
Actions #1

Updated by Brett Smith about 9 years ago

  • Subject changed from Top Navbar of docs homepage not suitable for small window to [Documentation] Top Navbar of docs homepage not suitable for small window
  • Category set to Documentation
  • Target version set to Bug Triage
Actions #2

Updated by Nancy Ouyang about 9 years ago

This happens in-between "super small" where it turns into a mobile-friendly page, and "big" when the top navbar is flat.

Actions #3

Updated by Tom Clegg about 9 years ago

Debatably the problem is that there are too many top nav elements.

Suggest
  • Merge the nearly-useless "Admin Guide" content into the "Install" section
    • Call the merged section heading "Install" (drop "Guide")
    • Add the existing admin cheat sheet page to the Install section ("Setting up new users"?)
    • Update the cheat sheet so it also tells you to use Workbench → Users → Setup for adding users, VMs, and repos.
  • Rename "SDK Reference" to "SDKs"
  • Rename "API Reference" to "API"
Actions #4

Updated by Tom Clegg about 9 years ago

  • Target version changed from Bug Triage to 2015-04-01 sprint
Actions #5

Updated by Ward Vandewege about 9 years ago

  • Status changed from New to In Progress
  • Story points set to 0.5
Actions #6

Updated by Ward Vandewege about 9 years ago

  • Assigned To set to Ward Vandewege
Actions #7

Updated by Tom Clegg about 9 years ago

LGTM, but it exposes an existing bug which you should probably fix:

In #4186, ed4105d added a link to install-compute-node.html (via _config.yml) but didn't add that file. At the time it added a thin invisible link (invisible until you hover it, at least) under "install the crunch dispatcher" in the left nav, which was hard to notice because it looks like a bit of spacing between sections. Now, with bf213b6, the invisible link is noticeable as extra whitespace between "install the crunch dispatcher" and "cheat sheet" items.

Should add the install-compute-node.html.textile.liquid that was missing in #4186, or remove the reference to it in _config.yml.

Aside: yes, we're systematically checking for dead links, but apparently the dead-linked left nav item gets rendered as a link to baseurl instead of the missing page, so as far as linkchecker can tell it's perfectly good.

Actions #8

Updated by Ward Vandewege about 9 years ago

  • Status changed from In Progress to Resolved
Actions

Also available in: Atom PDF