My roadmap/to-do list

[falbrechtskirchinger]

In absence of a better place to put this and not lose it, I'll keep my personal list of issues and things to (maybe) work on here.

• Parity:
  • json_pointer overloads: count(), erase(), ...
  • iterator overloads: emplace(), ...
  • _ordered_json
  • index overloads for value()
• Move SaxEventCountdown to a separate header, and explore adding CHECK() to dtor and verifying the expected SAX event causes the abort.
• Add support for aliases to serve_header.py.
• std::optional!!!
• Add CMake fuzz targets. (IN PROGRESS)
• Fix docset loading online resource. (See below.)
• Move docset generation to Python and parse mkdocs.yml:
  • Make sure links exist for all entities documented in one file, e.g., JSON_HAS_CPP_11, JSON_HAS_CPP_14, etc. are all documented in json_has_cpp_11.md.
  • Auto-generate titles. Maybe, the docset index can even be fully generated automatically.
  • Download online resources and patch the generated HTML.
• Clean up type traits.
• Move built-in conversions into from_json_internal/to_json_internal.
• Add override mechanism for builtin conversions (xwidgets doesn't compile with version >3.10.3 #3602, [4.0.0] Require users to explicitly define StringType, etc. #3603, Override conversion for STL-like user types #3699).
• Check examples for namespace nlohmann.
• Can json_pointer::to_string be improved? (eliminate temporaries in accumulate; also, noexcept)
• Add remaining operators to json_pointer and document all operators.
• Check value<nullptr_t>() and add unit tests if necessary.
• Take another look at Niels' proposal for the namespace documentation.
• parse() should return the iterator to where it stopped.
• Use CMake variable expansion and quotes in a consistent and sensible manner.

Notes:

Print raw discussion text

gh api graphql -f query='query { repository(owner: "nlohmann", name: "json") { discussion(number: 3710) { body } } }' | jq -r '.data.repository.discussion.body'