Page MenuHomePhabricator

Revise Help:Toolforge
Closed, ResolvedPublic

Description

Current page:
https://wikitech.wikimedia.org/wiki/Help:Toolforge

Draft revision:
https://wikitech.wikimedia.org/wiki/User:Triciaburmeister/Sandbox/Help:Toolforge

TODO:

  • Resolve TODOs via interviews with SMEs
  • Copyediting
  • Layout and visual design improvements
  • SME / WMCS team member review
  • Replace current page with new revision
  • Tech writer peer review
  • Update incoming anchor links where feasible

Event Timeline

TBurmeister changed the task status from Open to In Progress.
TBurmeister triaged this task as Medium priority.
TBurmeister moved this task from Backlog to In progress on the Tech-Docs-Team board.
TBurmeister updated the task description. (Show Details)
TBurmeister updated the task description. (Show Details)

@apaskulin Assigning this to you for a copyedit please. Soft deadline of September 15 (Friday) if possible. Thanks!

(I had to publish the page to unblock publishing of changes on Portal:Toolforge but I will still apply any copyedits you suggest to the final revision!)

Awesome work! The what is Toolforge and what are tools and bots sections are perfection! I made a few minor edits to page directly.

  • "mosh, SSH, SFTP" – It would be good to link to a Wikipedia article for each of these since they are likely to be unfamiliar terms.
  • "Version control via Gerrit and Git" – I recommend removing Gerrit. The page this line links to includes multiple options (GitLab, etc.), so I don't think it's necessary to call out Gerrit, and it makes for one less unfamiliar term in the list.
  • I love the constraints section! I expected to see something here about licensing your code under an open source license, but that is technically covered under the Cloud Services terms of use. Up to you!
TBurmeister claimed this task.
TBurmeister updated the task description. (Show Details)
TBurmeister moved this task from In progress to Done on the Tech-Docs-Team board.
TBurmeister added a subscriber: apaskulin.