Skip to content

docs: expand architecture.md to cover all 20 crates#14830

Open
0xAxiom wants to merge 1 commit into
foundry-rs:masterfrom
0xAxiom:docs/architecture-crate-descriptions
Open

docs: expand architecture.md to cover all 20 crates#14830
0xAxiom wants to merge 1 commit into
foundry-rs:masterfrom
0xAxiom:docs/architecture-crate-descriptions

Conversation

@0xAxiom
Copy link
Copy Markdown

@0xAxiom 0xAxiom commented May 19, 2026

Closes #13880

What

The previous docs/dev/architecture.md documented only 3 crates (evm/, config/, cli/). This PR extends it to cover all 20 crates currently in crates/, grouped by role:

Group Crates
Binaries forge, cast, anvil, chisel
Core Libraries evm, cheatcodes, config, common, primitives
CLI & TUI cli, cli-markdown, debugger
Compilation & Formatting fmt, lint, doc, linking, sol-macro-gen
Scripting & Deployment script, script-sequence, verify
Testing & Internal Utilities macros, test-utils

Why

Issue #13880 called out that the majority of crates had no architectural documentation. Descriptions were sourced from each crate's Cargo.toml description field, lib.rs doc comment, and/or README.md.

Existing entries (evm/, config/, cli/) are preserved and lightly expanded. No code changes.

Closes foundry-rs#13880

The previous architecture.md documented only 3 crates (evm, config, cli).
This extends it to cover all 20 crates currently in the repo, grouped by role:

- Binaries: forge, cast, anvil, chisel
- Core Libraries: evm, cheatcodes, config, common, primitives
- CLI & TUI: cli, cli-markdown, debugger
- Compilation & Formatting: fmt, lint, doc, linking, sol-macro-gen
- Scripting & Deployment: script, script-sequence, verify
- Testing & Internal Utilities: macros, test-utils

Descriptions sourced from Cargo.toml, lib.rs doc comments, and crate READMEs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

docs: architecture.md is outdated and missing coverage for most crates

1 participant