Linting for documentation

To make this file a standalone documentation file rendered together with the rest of the CAT documentation, it needs to pass linting. This MR fixes some linting errors and a adds a couple of links pointing to scripts and yaml files in the reporitory.