Page MenuHomePhabricator

Update Cloud VPS docs structure and landing pages
Closed, ResolvedPublic

Description

This subtask is for tracking work specific to the user-facing Cloud VPS docs separately from the other docs in the Cloud Services content collection.

Milestones:

[not feasible] Research and design initial prototype of task-focused information architecture for Cloud VPS content
[done] Initial content audit and identification of major docs tasks
[done] Create / revise landing pages
[done] Create / revise navigation template
[done] File phab tasks for non-landing-page doc edits

Event Timeline

TBurmeister changed the task status from Open to In Progress.Jul 7 2023, 4:59 PM
TBurmeister triaged this task as Low priority.

Navigation template is updated. Some highlights:

  • Added "Get started" section
  • Removed or relocated content based on its utility for users, with the links most useful for getting started at the top and admin links at the bottom
  • Added :Get Help" section
  • Added category search and confirmed that all pages that are linked from the nav menu have the category "Cloud VPS".
  • Added missing link for Trove database user guide to the menu
  • Added links for Horizon UI and list of VPS projects in OpenStack browser

I didn't file a subtask for this, but I ended up making significant revisions to https://wikitech.wikimedia.org/wiki/Help:Cloud_VPS_project as part of my changes to Portal:Cloud_VPS in T347349 and Help:Cloud_VPS in T347350. Much of the information on Portal:Cloud_VPS was duplicated on Help:Cloud_VPS_project or made more sense on the revised landing page Help:Cloud_VPS.