Link mdoc generation tasks to test:compile and release process.

[paul-a-kennedy-rally]

The current project (as of 2628c58) has support for docs using the codebase for "live" examples.

There are two use cases for this "live" documentation:

• It functions as a test and should be maintained as such.
• It functions as documentation that should be published as part of a release.

This issue is to link the mdoc generation process to testing and to documentation release.

[jeffmay]

I was thinking we could create a pre-commit hook / CI check that the documents are regenerated (excluding timestamps, somehow) when the source doc file changes.

[paul-a-kennedy-rally]

I think that the point is to ensure that the running code within the documentation keeps pace with the source code.

Ensuring that this code is a first class citizen is to ensure that code in the documentation actually compiles and is not left as an afterthought.