There are many pages/locations of PAWS documentation listed at https://wikitech.wikimedia.org/wiki/PAWS#Documentation some of which needs to be merged or updated.
There are 2 related ideas that need to be kept in mind:
The existing documentation should be organized and centralized, in order to make information easier to find, with the future improvements to the tool's own interface as part of the planning.