Background

This section captures why parts of curl look the way they do. It is the place to go for design rationale, accumulated wisdom, and warnings about places that look refactor-friendly but are not.

Page	Topic
Design decisions	Notable architectural choices and why they were made

The companion files in the source tree:

• docs/HISTORY.md — narrative timeline (mirrored in Lore)
• docs/INTERNALS.md — short pointer to the "everything curl" book
• docs/TODO.md — long-running ideas and feature requests with maintainer interest
• docs/KNOWN_BUGS.md — known broken behaviours awaiting fixes
• docs/KNOWN_RISKS.md — accepted security trade-offs
• docs/EXPERIMENTAL.md — features still gated experimental
• docs/DEPRECATE.md — features queued for removal
• docs/BINDINGS.md — third-party libcurl bindings catalog