Background: PAWS Kubernetes is currently undergoing an upgrade: https://phabricator.wikimedia.org/T211096, which makes this a good time to revisit documentation.
A cursory audit of PAWs documentation on Wikitech, Mediawiki, and Metawiki included the following pages and links:
- https://wikitech.wikimedia.org/wiki/PAWS
- https://wikitech.wikimedia.org/wiki/PAWS/Introduction
- https://wikitech.wikimedia.org/wiki/SWAP
- https://wikitech.wikimedia.org/wiki/Talk:PAWS
- https://wikitech.wikimedia.org/wiki/PAWS/Tools/Admin
- https://wikitech.wikimedia.org/wiki/Portal:Toolforge/Nodes#PAWS_nodes
- https://wikitech.wikimedia.org/wiki/Nova_Resource:Paws
- https://wikitech.wikimedia.org/wiki/Nova_Resource:Paws/SAL
- https://wikitech.wikimedia.org/wiki/Nova_Resource:Tools.paws/SAL
- https://wikitech.wikimedia.org/wiki/Nova_Resource:Tools.paws-beta/SAL
- https://icinga.wikimedia.org/cgi-bin/icinga/status.cgi?host=paws.wmflabs.org
- https://wikitech.wikimedia.org/wiki/PAWS/Tools/Admin/Chico%27s_notes
- https://wikitech.wikimedia.org/wiki/Documentation_For_PAWS
- https://wikitech.wikimedia.org/wiki/PAWS/Tools
- https://www.mediawiki.org/wiki/PAWS
- https://www.mediawiki.org/wiki/Manual:Pywikibot/PAWS
- http://paws-public.wmflabs.org/paws-public/User:Jtmorgan/ds4ux/paws-cheatsheet.ipynb
- https://phabricator.wikimedia.org/tag/paws/
- https://github.com/toolforge/paws
- https://tools.wmflabs.org/admin/tool/paws
Note: This is an initial audit. There may be more relevant pages that could be included in this ticket.
These pages should be evaluated for relevancy, updated/improved, and combined where necessary. We should also determine whether any new pages or visualizations should be included in the documentation.
PAWS documentation is on both Wikitech and Mediawiki. This could make user navigation difficult, and it may also mean that information is duplicated or different depending on the venue. We should think about the impact this could have and may want to consider consolidating the documentation in one place.