Make a documention / blueprint documentation generator

[NullVoxPopuli]

like with package.json maybe we have package.json.docs.md or mirrored docs/package.json.md

that the tool can look up and show side-by-side what's going on line-by-line.

<!-- line:2 -->
name: this is the published name of the package