chore(docs): tooling to keep hand-written docs in sync with implementation

chore(docs): tooling to keep hand-written docs in sync with implementation #4183