I had a few minutes spare this morning so I rushed out a summary video of how MetaDocs is looking after the jam (apologies for lack of polish, I didn't have time to plan it out fully): https://youtu.be/kKppU0zcXjM
Highlights:
- reading clang's AST from JSON into C structures, deduplicating repeated nodes
- converting that into a more convenient structure for navigating symbols and their attached documentation comments
- starting to autogenerate a markdown-like syntax for symbols and attaching the documentation text
- evaluating constant expressions from the AST for enum values
Still to finish:
- representing primitive types in the same way as custom types
- finalising binary and JSON outputs
- complete example translating to a final HTML
- library methods to assist with references between documentation and symbols
- proper scoping of types