Page MenuHomePhabricator

Expose default documentation space in Wikitech for Toolforge tools in ToolsAdmin and/or Toolhub
Open, LowPublic

Description

This was brought up in Team challenges in Wikimania 2026.

Currently, In tools admin, you can set a gitlab repo or create a project in Phabricator:

grafik.png (469×535 px, 27 KB)

It would be really nice if we could also set an official documentation space for the tool too. Connect it and advertise it publicly in toolhub. Right now, the documentation around toolforge tools are scattered and hard to find.

My preference would be having something like a wiki page with subpages (e.g. Tool:Stashbot in Wikitech) with a pre-filled box but open to other ideas

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript

My preference would be having something like a wiki page with subpages (e.g. Toolforge:Coverme in wikitech.wikimedia.org) with a pre-filled box but open to other ideas

Wikitech has the Tool and Nova Resource namespaces for Toolforge (e.g., Tool:Stashbot) and CloudVPS (e.g., Nova Resource:Deployment-prep).

Bugreporter subscribed.

But this should be linked from Striker.

My preference would be having something like a wiki page with subpages (e.g. Toolforge:Coverme in wikitech.wikimedia.org) with a pre-filled box but open to other ideas

Wikitech has the Tool and Nova Resource namespaces for Toolforge (e.g., Tool:Stashbot) and CloudVPS (e.g., Nova Resource:Deployment-prep).

I was aware of Nove_Resource, but not Tool namespace at all. It would be really nice to make this more official and prominent.

aputhin renamed this task from Set up a dedicate and official space for documenation of toolforge tools to Expose default documentation space in Wikitech for Toolforge tools in ToolsAdmin and/or Toolhub.Aug 5 2026, 2:23 PM
aputhin triaged this task as Low priority.
aputhin updated the task description. (Show Details)
taavi subscribed.

The toolinfo field has a field for an URL to documentation. I think it would be pretty simple to create a button in Striker that creates a Wikitech Tool: page on some template and adds it to the toolinfo record, similar to the recently added prompts to automatically add new GitLab repos and Phabricator projects to the toolinfo record.

T123429: Create a Tool namespace on wikitech for documentation of Tool Labs projects has been there for 10 years.
https://wikitech.wikimedia.org/wiki/Category:Toolforge_tools includes

Tool maintainers: Make your tool easier to find by creating a page in the Tool namespace and using the Tool template.

https://wikitech.wikimedia.org/wiki/Tool:Gitlab-account-approval is a random example of a doc page.

Better docs/advertising for this is certainly welcome.