The documentation approach has been entirely changed since they were first written, which is why this task exists to supersede #1.
