Page MenuHomePhabricator

Update and Improve Toolforge and Cloud VPS Technical Documentation
Open, In Progress, MediumPublic

Description

Background:

There are a plethora of open tickets requesting new and improved Technical documentation for Toolforge. Improvements to documentation have also been consistently requested in the annual Toolforge survey. Gaps in consistency and documentation have been identified by users and collaborators. Many aspects of Toolforge are well-documented and some are not documented at all. This can lead to an inconsistent experience for technical collaborators.

Proposal

  • Review and reorganize existing Toolforge and Cloud VPS technical documentation for better readability. Update outdated information for existing pages with simple updates, and file tasks for ones which require more complicated updates
  • Review, prioritize, and resolve current outstanding Phabricator tasks / requests for updates and improvements to Toolforge and Cloud VPS technical documentation
  • Seek ways to improve organization and search-ability so users can find what they need
  • Solicit additional feedback from Toolforge and Cloud VPS users regarding usefulness and accuracy of Toolforge and Cloud VPS technical documentation (qualitative interviews and survey)
  • Create and foster a feedback process, so users can surface issues with technical documentation and make requests for new technical documentation, which are addressed promptly and clearly

Related Objects

StatusSubtypeAssignedTask
In ProgressTBurmeister
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
Resolved srodlund
OpenNone
ResolvedAklapper
OpenNone
DuplicateNone
OpenNone

Event Timeline

srodlund renamed this task from Update and Improve ToolForge Technical Documentation to Update and Improve ToolForge and Cloud VPS TechnicalDocumentation.Sep 9 2019, 9:57 PM
srodlund updated the task description. (Show Details)
srodlund renamed this task from Update and Improve ToolForge and Cloud VPS TechnicalDocumentation to Update and Improve ToolForge and Cloud VPS Technical Documentation.Sep 9 2019, 10:11 PM
Krinkle renamed this task from Update and Improve ToolForge and Cloud VPS Technical Documentation to Update and Improve Toolforge and Cloud VPS Technical Documentation.Apr 22 2022, 9:34 PM
TBurmeister changed the task status from Open to In Progress.Jul 17 2023, 7:57 PM
TBurmeister claimed this task.
TBurmeister triaged this task as Medium priority.

I have claimed this task because some (but not all) of the work it describes will overlap with my work on T327319. I will also claim any subtasks that I intend to work on as part of that project, and file additional ones as needed for the doc work the project has identified.