Generate documentation from the inspections

[mwz]

Since all the inspections now have up-to-date metadata, which is accessible from the code, we can automate generating documentation that could replace the
inspections section in the readme file https://github.com/sksamuel/scapegoat#inspections.

Probably a separate markdown page that could be linked from the readme would be the easiest thing to start with.

[mwz]

I might take a look at this.
Does anyone have any thoughts, e.g. are you ok with generating a separate markdown page with a list of inspections? Something similar to the existing format (a table) would probably work fine for now?