Skip to content

docs: enhance README with comprehensive project documentation#12

Open
devin-ai-integration[bot] wants to merge 2 commits intomainfrom
devin/1777270146-enhance-readme
Open

docs: enhance README with comprehensive project documentation#12
devin-ai-integration[bot] wants to merge 2 commits intomainfrom
devin/1777270146-enhance-readme

Conversation

@devin-ai-integration
Copy link
Copy Markdown

What

Complete rewrite of the README to accurately reflect the current state of the project.

Why

The existing README was outdated -- it didn't cover several features added since the initial release (expert reviews, local codebase support, output formats, the full configuration surface, etc.) and was missing architectural context that helps new users and contributors understand the project.

How

Key additions and changes:

  • Header: Centered logo, badges (npm version, license, Python, Node)
  • Tagline: Updated to reflect Issue and local codebase support (not just PRs)
  • Architecture diagram: Updated with actual sandbox tech (Deno/Pyodide) and tool names (FETCH_FILE, SEARCH_CODE, LIST_DIRECTORY)
  • Expert Code Review section: Documents --expert flag, built-in checklists (SOLID, security, code quality, removal), and severity levels (P0-P3)
  • Output Formats section: --output markdown/json, --quiet flag
  • Local Codebase Review section: --path flag
  • Configuration table: All env vars from .env.example with types, defaults, and descriptions
  • Architecture section: Directory tree with file-level descriptions, how-it-works explanation, and tech stack table (DSPy, Gemini, Deno, Pyodide, FastAPI, React, Vite)
  • Development section: Quick-reference commands for tests, linting, and building
  • Supported Platforms section: macOS ARM64/x64, Linux x64
  • Links to INSTALLATION.md and CONTRIBUTING.md

Testing

  • Self-reviewed
  • No code changes -- documentation only

Checklist

  • Code follows project style
  • Self-reviewed
  • No breaking changes (or documented)

Link to Devin session: https://app.devin.ai/sessions/6607794c5d2b4080b7c649098ae618d9
Requested by: @sng-asyncfunc

- Add centered logo, badges (npm, license, Python, Node versions)
- Update tagline to reflect Issue and local codebase support
- Update architecture diagram with Deno/Pyodide sandbox and tool names
- Add Expert Code Review section (--expert flag, checklists, severity levels)
- Add Output Formats section (markdown, json, --quiet)
- Add Local Codebase Review section (--path flag)
- Add full Configuration table with all env vars and defaults
- Add Architecture section with directory tree and how-it-works explanation
- Add Tech Stack table (DSPy, Gemini, Deno, Pyodide, FastAPI, React, Vite)
- Add Development quick-reference commands
- Add Supported Platforms section (macOS ARM64/x64, Linux x64)
- Link to INSTALLATION.md and CONTRIBUTING.md

Co-Authored-By: Sheing Ng <sng@asyncfunc.ai>
@devin-ai-integration
Copy link
Copy Markdown
Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

Co-Authored-By: Sheing Ng <sng@asyncfunc.ai>
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