General advice as these seem pretty light (at least for now), if you went in any of the projects, could you use these docs to describe what all of the files do and how they all link together?

Added a bit more info & list of symbols. Anything I forgot to mention / that's unclear?

• What is the Type ID? Where does it come from?
• Where does the type store come from in SymbolVisitor? Is it new?
• Could do with some example code, might be in the form of a link or an actual code snippet.
• How do the type references work? Again links back to what are the type IDs.
• Formatting documentation is awesome!
• Visitor documentation is awesome!
• Type resolution documentation doesn't actually indicate how the resolution logic works. I appreciate XML docs are used for individual type/function documentation, but the essence of the logic should still be documented I think.
• Scraper documentation is a bit lacking as well, not really describing the essence of the logic.
  • e.g. "we invoke ClangSharp to get XML outputs, then we read that XML output (via the XmlVisitor) and convert it into the symbols described by the symbol layer, and that gets passed to ???"
• Clang doesn't output XML, ClangSharp does though. This could be confusing as to where to look for further information.
• Testing documentation is awesome!

Future:

• Where do all of these symbols come from? Is there an example of them being created?
• Where is the SymbolVisitor used in the other components? Is there an example you can link to?

I've addressed most of those concerns, thanks a lot for the detailed response!
I'm a little confused about the scraper docs, not sure what else I can really add, can you elaborate?
The hope would be that the scraper is very straight forward and only a small bridge between ClangSharp XML output and the symbol layer.

Merging this to unblock follow up work, but I'll follow up in another PR. Feel free to comment here

The hope would be that the scraper is very straight forward and only a small bridge between ClangSharp XML output and the symbol layer.

So say that! :D

Addressed all of these in #1015