"Advanced rkyv" book

[djkoloski]

Most of the documentation currently available either explains the very high-level or the very low-level parts of rkyv. Most people struggle getting from one end to the other. An appropriate kind of documentation to fill that gap could be a book that covers advanced parts of the library. Some possible topics:

• Serializer composition: what is CompositeSerializer and the different roles of a writer, scratch space, and shared pointer map
• Alternative writers: writing directly to a file, byte buffer, etc.
• Extending serialization with your own traits
• How to use ZCD and traditional deserialization in harmony (e.g. deserializing subobjects)
• When to use wrapper types and how to use them effectively: transparent foreign type support, customizable serialization, non-default behavior
• Archived vs original types and impl duplication
• Streaming serialization approaches: fixed-size types, two-file solution, manual framing
• Validation: bytecheck, object subtrees, the default validator, adding validation capabilities
• Schema evolution: enums of boxed data, no comprehensive proto solution yet
• Copy optimization and nightly features
• Derive macro features: archive_attr, omit_bounds/archive(bound(...)), archive(compare(PartialEq, PartialOrd))

[djkoloski]

Scaffolding set up in 612e03108d568c05b75d77bc938345cf0c0ccde0. This will probably take a while to get all filled out, so let's take it a little bit at a time.