Design Docs
The NSmithy design documents live in the
designs/
folder of the repository. Each document covers a specific area of the system:
its goals, the chosen design, alternatives considered, and tradeoffs.
| Document | Area |
|---|---|
| codegen-architecture.md | Java plugin + MSBuild integration pipeline |
| shapes.md | Smithy shape → C# type mapping |
| serialization.md | Schema-aware codec and serialization design |
| http-interfaces.md | HTTP transport abstractions |
| client-architecture.md | Generated client lifecycle, config, interceptors, auth, retries |
| native-grpc.md | Native gRPC: own proto codec + gRPC protocol (no protoc/Grpc.Net) |
| streaming.md | Event streams and streaming blob payloads |