Skip to content

docs: rework project documentation for clarity and navigation#10

Merged
AndrewAltimit merged 1 commit intomainfrom
docs/rework-documentation
Mar 3, 2026
Merged

docs: rework project documentation for clarity and navigation#10
AndrewAltimit merged 1 commit intomainfrom
docs/rework-documentation

Conversation

@AndrewAltimit
Copy link
Owner

Summary

  • Rewrote README.md following the template-repo documentation style: concise opener, "Use this repo to learn how to" section, Quick Start with build commands, proper tree diagrams, richer crate descriptions, Documentation index table, Companion Repository link, and GitHub Pages reference
  • Replaced oversized OpenAI security section (18 lines of editorial) with a brief one-line notice that links to the template repo for full context
  • Cleaned up AGENTS.md and CONTRIBUTING.md to remove stale Codex-specific references

Test plan

  • Pre-commit hooks pass (fmt, clippy, tests)
  • Verify all documentation links resolve correctly
  • Review README rendering on GitHub

Generated with Claude Code

Rewrite README.md following the template-repo documentation style:
- Add concise project description and "Use this repo to learn" section
- Replace oversized OpenAI security section with a brief notice
- Add Quick Start with build commands
- Use proper tree characters in diagrams
- Add richer crate descriptions with technical details
- Add Documentation index table linking all docs
- Add Companion Repository reference to template-repo
- Link to GitHub Pages site

Clean up satellite docs:
- AGENTS.md: remove inline Codex security note from CI section
- CONTRIBUTING.md: remove specific agent names (Codex reference)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@AndrewAltimit AndrewAltimit merged commit 635357a into main Mar 3, 2026
3 checks passed
@AndrewAltimit AndrewAltimit deleted the docs/rework-documentation branch March 3, 2026 08:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant