Skip to content

docs: refactor documentation for v2 - #136

Merged
norberia merged 1 commit into
mainfrom
docs/refactor-claude-md
Mar 4, 2026
Merged

docs: refactor documentation for v2#136
norberia merged 1 commit into
mainfrom
docs/refactor-claude-md

Conversation

@norberia

@norberia norberia commented Mar 4, 2026

Copy link
Copy Markdown
Collaborator

Summary

Refactor documentation to reflect Fulling v2 vision and improve clarity for different audiences.

CLAUDE.md (850+ → 155 lines, -82%)

  • Update project name to Fulling v2
  • Refine core value: Free users' mental bandwidth through AI Agents
  • Add Project Structure section for v2 architecture
  • Remove implementation details from Key Design Decisions
  • Update code style guidelines (self-documenting code)
  • Remove specific image version references

README.md (Rewrite)

  • User perspective instead of developer perspective
  • Add "What is Fulling?" with clear value proposition
  • Add "Configuration-driven development" messaging
  • Simplify Features (focus on user benefits, not tech details)
  • Replace Tech Stack with "Built With" (minimal, no versions)
  • Replace Installation with "Self-Hosting" (for contributors)
  • Remove redundant env variable list (point to .env.template)
  • Update footer with AI model credits

docs/

  • Remove api.md, database.md (code is self-documenting)
  • Add architecture.md, development.md, operations.md, troubleshooting.md

Test Plan

  • Review CLAUDE.md for accuracy
  • Review README.md for user clarity
  • Verify all internal links work

CLAUDE.md:
- Update project name to Fulling v2
- Refine core value: free users' mental bandwidth through AI Agents
- Add Project Structure section
- Remove implementation details from Key Design Decisions
- Update code style guidelines (self-documenting code)
- Remove specific image version references

README.md:
- Rewrite from user perspective (not developer perspective)
- Add "What is Fulling?" section with clear value proposition
- Add "Configuration-driven development" messaging
- Simplify Features section (focus on user benefits)
- Replace Tech Stack with "Built With" (minimal, no versions)
- Replace Installation with "Self-Hosting" (for contributors)
- Remove redundant env variable list (point to .env.template)
- Move "Star us" to end of file
- Update footer with model credits

docs/:
- Remove api.md (code is the best documentation)
- Remove database.md (schema is self-documenting)
- Add architecture.md, development.md, operations.md, troubleshooting.md
@github-actions

github-actions Bot commented Mar 4, 2026

Copy link
Copy Markdown

✅ PR Check Results: Passed

Build Checks

Check Status
Lint & Build ✅ Passed
Docker Build ✅ Passed

✨ Great work!

All checks passed successfully. Your PR is ready for review.

Details:

  • ✅ Code quality verified (linting passed)
  • ✅ Build successful
  • ✅ Docker image build verified (linux/amd64)
    Commit: 1e1d4b0e6417aaf04f0fc01c8a669962d49ea12d
    Branch: docs/refactor-claude-md

🔗 View Details:

@norberia
norberia merged commit 3ff625d into main Mar 4, 2026
6 checks passed
@norberia
norberia deleted the docs/refactor-claude-md branch March 4, 2026 13:01
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