Skip to content

Conversation

@AdekunleBamz
Copy link

Summary

This PR adds comprehensive README documentation to the contracts directory and its subdirectories to improve code navigation and developer onboarding.

Changes Added

New Files (7 READMEs)

  1. contracts/README.md

    • Overview of the contract structure
    • Directory descriptions for beanstalk, ecosystem, interfaces, libraries, mocks, pipeline, tokens
    • Explanation of EIP-2535 Diamond architecture
  2. contracts/beanstalk/README.md

    • Documentation of core Diamond contracts
    • Facet organization overview
    • Storage and initialization patterns
  3. contracts/beanstalk/facets/README.md

    • Complete reference of all facets organized by category
    • Diamond, Farm, Field, Market, Silo, and Sun facet documentation
    • Description of each facet's purpose
  4. contracts/ecosystem/README.md

    • Peripheral contract documentation
    • Price oracle, gauge points, and tractor utilities
  5. contracts/libraries/README.md

    • Categorized library documentation
    • Storage, math, protocol, silo, convert, token, and oracle libraries
    • Usage examples
  6. contracts/tokens/README.md

    • Bean token documentation
    • ERC20 extensions overview
  7. contracts/pipeline/README.md

    • Pipeline utility documentation
    • Call composition and integration examples

Why This Change

Comprehensive documentation helps developers understand the codebase structure, navigate the Diamond architecture, and quickly find relevant contracts and libraries.

- Add contracts/README.md with overview of directory structure
- Add contracts/beanstalk/README.md documenting Diamond architecture
- Add contracts/beanstalk/facets/README.md with complete facet reference
- Add contracts/ecosystem/README.md for peripheral contracts
- Add contracts/libraries/README.md categorizing all libraries
- Add contracts/tokens/README.md documenting Bean token
- Add contracts/pipeline/README.md explaining Pipeline utility
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