Curated design notes, taxonomies, inventories, and surveys that document why h5cpp looks the way it does — and where it's going. These complement the auto-generated API reference (function signatures and class trees) with the prose that explains the design decisions behind them.

Architecture & Design

The "why does this layer exist and how was it built" reports.

h5cpp Type-System Map — Today's Reality — the live type-system map (every C++ source type → HDF5 type → storage mechanism)
h5cpp Multithreaded Filter Pipeline — Current State (v1.12.7) — current state of the multithreaded filter pipeline in v1.12.7 (h5::high_throughput DAPL + h5::append packet-table paths)
h5cpp-compiler Multi-Backend Architecture — h5cpp-compiler's plug-in serialisation backend framework (11 backends: HDF5 + Protobuf + JSON + MsgPack + CBOR + BSON + Avro + RLP + SQL ×3 dialects)

Inventories & Guides

Exhaustive catalogues of what's available and how to use it.

H5CPP Handle Inventory & Pretty-Print Status — every RAII handle wrapper (16 property lists + 5 async-mode variants + the 6 object handles), pretty-print status
H5CPP Filter Inventory & Use Guide — gzip / shuffle / fletcher32 / nbit / scale-offset / SZIP / Gorilla / custom filters, with use-case guidance
H5CPP STL Pretty-Print Guide — h5::cout / h5::pprint formatting recipes for the supported container family

h5cpp-compiler Attribute Taxonomies

One taxonomy per backend — exhaustive attribute vocabulary that the h5cpp-compiler's AST walker parses to produce each artifact.

h5:: Attribute Vocabulary (HDF5 Backend) — [[h5::*]] (the HDF5 / cross-backend universals)
pb.hpp Attribute Vocabulary — [[pb::*]] (Protocol Buffers — fields, services, RPC, wire knobs)
json:: Attribute Vocabulary (JSON Schema Backend) — [[json::*]] (JSON Schema — formats, validation, naming)
avro:: Attribute Vocabulary (Avro Backend) — [[avro::*]] (Apache Avro — logical types, aliases, defaults)
bson:: Attribute Vocabulary (BSON Backend) — [[bson::*]] (BSON — binary, datetime, decimal, timestamp)
cbor:: Attribute Vocabulary (CBOR Backend) — [[cbor::*]] (CBOR — RFC 8949 semantic tags)
msgpack:: Attribute Vocabulary (MessagePack Backend) — [[msgpack::*]] (MessagePack — extension types)
rlp:: Attribute Vocabulary (RLP Backend) — [[rlp::*]] (Ethereum RLP — minimal annotation set)
sql:: Attribute Vocabulary (SQL Backend) — [[sql::*]] (SQL DDL — column types, constraints, dialects)

Surveys & Comparisons

h5cpp-compiler Prior Art Survey — competitive landscape: rootcling, serde, nlohmann/json codegen, etc.
Top 10 Most Frequent HDF5-Related Bugs — top 10 most frequent HDF5-related bugs h5cpp's design avoids by construction

Project Assessment

h5cpp Usability Evaluation — v1.12.7 per-category feature scorecard with rationale (✔ / ◇ / ✘ status across 13 dimensions)

Source-of-thought vs source-of-truth

The reports in this section are the published reference — what consumers of the docs site should know. The corresponding workspace- internal source-of-thought documents live in vargalabs-workspace/tasks/h5cpp-*.md and may carry more deliberation (rejected alternatives, open questions, ephemeral analysis). Treat the published version as the canonical statement; treat the workspace version as the history of how we got here.