Page MenuHomePhabricator

Host bridge storybook on doc.wikimedia.org
Closed, ResolvedPublic3 Estimated Story Points

Description

Since some time ago, Termbox seems to host their storybook on doc.wikimedia.org: https://doc.wikimedia.org/wikibase-termbox/master/ui

Hosting our bridge storybook there as well should have multiple benefits:

  • reliable automatic updates
  • intuitive place to look for documentation
  • not misusing toolforge for something it wasn't intended for
  • using a technology we understand somewhat better

Steps to take:

  • build storybook into (wikibase?) doc/ directory when running npm run doc
  • somehow make this happening with CI (see discussion in mattermost, npm run doc is already executed by CI)
  • add deep link to our storybook on https://doc.wikimedia.org via the repository integration/docroot (Gerrit, diffusion)
  • remove existing storybook installation on toolforge
  • update existing documentation on wikitech about the old storybook being removed
  • review whether storybook is mentioned as part of the documentation on mediawiki.org

Prior art by Termbox:

https://gerrit.wikimedia.org/r/c/wikibase/termbox/+/539208
https://gerrit.wikimedia.org/r/c/integration/config/+/556043

This effectively replaces T235763: Investigate broken Wikidata Bridge Storybook updates

Event Timeline

Change 563192 had a related patch set uploaded (by Michael Große; owner: Michael Große):
[mediawiki/extensions/Wikibase@master] Publish Bridge storybook to doc.wikimedia.org

https://gerrit.wikimedia.org/r/563192

Change 563192 merged by jenkins-bot:
[mediawiki/extensions/Wikibase@master] Publish Bridge storybook to doc.wikimedia.org

https://gerrit.wikimedia.org/r/563192

Change 563405 had a related patch set uploaded (by Michael Große; owner: Michael Große):
[integration/docroot@master] Ad links to our storybooks on doc.wikimedia.org

https://gerrit.wikimedia.org/r/563405

Change 563405 merged by jenkins-bot:
[integration/docroot@master] Add links to our storybooks on doc.wikimedia.org

https://gerrit.wikimedia.org/r/563405

remove existing storybook installation on toolforge

see Toolforge (Tools to be deleted)

Thanks, that will be helpful!

Mentioned in SAL (#wikimedia-cloud) [2020-02-12T14:32:05Z] <Lucas_WMDE> cleaned up tool (rm -rf a bunch of stuff) for T240340 and T245026