| name | dev |
| description | Maintainer guide for atlas_doc_parser development. Use when implementing ADF marks/nodes, understanding codebase architecture, or writing tests. |
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 definitionsadf-json-example- Fetch real ADF JSON from Confluence pagesimplement-model- Automated implementation workflow