Skip to content

Conversation

@adamamer20
Copy link
Member

Enhance the documentation structure and content for better clarity and usability. This includes updates to navigation, improved API references, and additional examples for key components. The changes aim to provide a more comprehensive and user-friendly experience for developers.

@codecov
Copy link

codecov bot commented Dec 8, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.23%. Comparing base (3037456) to head (69e407a).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #190   +/-   ##
=======================================
  Coverage   89.23%   89.23%           
=======================================
  Files          14       14           
  Lines        2007     2007           
=======================================
  Hits         1791     1791           
  Misses        216      216           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +118 to +121
- Tutorials:
- Introductory Tutorial: tutorials/2_introductory_tutorial.ipynb
- Advanced Tutorial: tutorials/3_advanced_tutorial.ipynb
- Data Collector Tutorial: tutorials/4_datacollector.ipynb

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Use existing tutorial paths in mkdocs nav

The navigation entries under “Tutorials” point to tutorials/2_introductory_tutorial.ipynb, 3_advanced_tutorial.ipynb, and 4_datacollector.ipynb, but the repository only includes .py tutorials in docs/general/tutorials and the existing notebook versions still live under docs/general/user-guide. MkDocs will error on build because the referenced files do not exist at the declared paths.

Useful? React with 👍 / 👎.

Comment on lines +32 to +40
self.datacollector = DataCollector(
model=self,
model_reporters={
"total_wealth": lambda m: m.sets["MoneyAgents"].df["wealth"].sum()
},
agent_reporters={"wealth": "wealth"},
storage="csv",
storage_uri="./data",
trigger=lambda m: m.schedule.steps % 2 == 0,

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Fix tutorial trigger to use Model.steps

The DataCollector trigger uses lambda m: m.schedule.steps % 2 == 0, but Model only exposes _steps/steps and has no schedule attribute; calling conditional_collect() will raise AttributeError before any data is recorded. The trigger should reference m.steps (or _steps) to match the core Model API.

Useful? React with 👍 / 👎.

@adamamer20
Copy link
Member Author

@coderabbitai review

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 8, 2025

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 8, 2025

Warning

Rate limit exceeded

@adamamer20 has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 28 minutes and 20 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 3037456 and 69e407a.

⛔ Files ignored due to path filters (3)
  • docs/general/plots/boltzmann.svg is excluded by !**/*.svg
  • docs/general/plots/sugarscape.svg is excluded by !**/*.svg
  • uv.lock is excluded by !**/*.lock
📒 Files selected for processing (18)
  • .gitignore (1 hunks)
  • CHANGELOG.md (1 hunks)
  • CONTRIBUTING.md (4 hunks)
  • README.md (1 hunks)
  • ROADMAP.md (1 hunks)
  • docs/api/conf.py (4 hunks)
  • docs/api/index.rst (1 hunks)
  • docs/api/reference/agents/index.rst (1 hunks)
  • docs/api/reference/datacollector.rst (1 hunks)
  • docs/api/reference/model.rst (1 hunks)
  • docs/api/reference/space/index.rst (1 hunks)
  • docs/general/changelog.md (1 hunks)
  • docs/general/index.md (1 hunks)
  • docs/general/tutorials/2_introductory_tutorial.py (1 hunks)
  • docs/general/tutorials/4_datacollector.py (1 hunks)
  • docs/general/user-guide/0_getting-started.md (5 hunks)
  • mkdocs.yml (4 hunks)
  • pyproject.toml (1 hunks)

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch split/docs-and-toptexts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@adamamer20 adamamer20 self-assigned this Dec 8, 2025
@adamamer20 adamamer20 added the docs Improvements or additions to documentation label Dec 8, 2025
@adamamer20 adamamer20 added this to the 0.2.0 milestone Dec 8, 2025
@adamamer20 adamamer20 requested review from Ben-geo and EwoutH December 8, 2025 23:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants