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 and Mediawiki 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.