atlas_doc_parser Maintainer Guide
This skill provides guidance for developing and maintaining the atlas_doc_parser library.
Available Topics
Read the specific document when you need detailed information:
| Topic | Document | When to Read |
|---|---|---|
| Overview | 01-What-is-atlas-doc-parser | Understanding project purpose and design philosophy |
| Three Sources | 02-Cross-Referencing | Learning about JSON schema, docs, and real Confluence pages |
| Base Classes | 03-The-Base-Class | Understanding Base, BaseMark, BaseNode, and markdown helpers |
| Implementation | 04-Per-Mark-Node-Class | Implementing a new mark or node dataclass |
| Testing | 05-How-to-Test | Writing tests for marks and nodes |
| Error Handling | 06-Graceful-Handling-of-Unimplemented-Types | How unimplemented types are handled gracefully |
Quick Reference
- •Implement new mark/node: Read "Implementation" then "Testing"
- •Understand architecture: Read "Overview" then "Base Classes"
- •Debug parsing issues: Read "Three Sources" and "Error Handling"
Related Skills
- •
adf-format-json-schema- Query ADF JSON schema definitions - •
adf-json-example- Fetch real ADF JSON from Confluence pages - •
implement-model- Automated implementation workflow