Design Documentation Update

[Eunovo]

This PR contains an attempt to improve the design documentation to help new contributors to the repo. It adds more details about BuildField, ReadField and PassField. It explains how Callbacks, ThreadMaps and Async processing work.

[DrahtBot]

The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

Reviews

See the guideline for information on the review process.

Type	Reviewers
ACK	ryanofsky
Concept ACK	Sjors

If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.

LLM Linter (✨ experimental)

Possible typos and grammar issues:

• resuse -> reuse [spelling error]
• capabilites -> capabilities [spelling error]

^{drahtbot_id_5_m}

[ryanofsky]

@theuni you may be interested in this, it describes things like how callbacks can be implemented

[enirox001]

This is a helpful update. As someone getting familiar with this, the new details really helped clarify the design.

[Sjors]

Concept ACK on expanding documentation, and thanks for adding these graphics.

Reviewer hint, switch to the rich diff:

@ryanofsky is probably best qualified to check correctness.

[ryanofsky]

Code review ACK 459a730. These updates are very good, and I think information about callbacks and context parameters should be especially helpful. I left a number of suggestions below, which can be addressed here or in a followup. You can let me know which you prefer.

[Eunovo]

Thanks for the review @ryanofsky . I made the suggested changes.

[ryanofsky]

Code review ACK cc234be. Thanks for the updates! All the descriptions seem accurate now, and hopefully the diagrams make it clear how the different classes fit together