Re-architect the notes.md file(s)

[arrdem]

At present monolithic notes.md files are used to store user documentation and notes for symbols. This has a number of disadvantages, primarily that the notes files tend to feature several common sections arities, docs, notes and related which are encoded in plain text. Ideally these would be separate data sources within a data store which would be composited/concatenated by an API consumer to produce formatted documentation rather than being hand formatted and hand managed.

Maybe what I want is to break out a docs.md from notes.md, providing both read-docs and read-notes for a Thing.

How can users provide additional metadata (arglists etc.) in the context of a notes store? How does this interact with read-meta for a Thing?

[arrdem]

The end concern here is essentially that due to notes.md lots of Grimoire notes contain hand formatting which could be avoided and instead generated from templating given a different storage/architecture of the same data.