Open
Description
Currently, mdoc's data model is basically the XmlDocument API ... the updater subcommand is tightly coupled with this API for both reading and writing. This project represents the effort to abstract the core data model, and make it so that it can work with multiple on-disk data formats (xml, yaml, etc)
Goals
- An abstract data model that can be used both to read, and write
- Easily represent all "alternate" values ... some elements are overload distinctive (return type, name, # of parameters, etc), and some are not (name of parameters, name of generic parameters, attributes).
- Make it easy to find the "diff" between two API sets.
- Represent authored content to allow for: importing from tripleslash, and automated content generation ... current tools work directly against the XML, which means they won't easily port to the SDP format.