Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add module-level docstring to experimental features #2532

Merged
merged 4 commits into from
Dec 4, 2024

Conversation

EwoutH
Copy link
Member

@EwoutH EwoutH commented Dec 4, 2024

This PR adds some module-level docstring to the experimental features. There is no real new information in there, just a nice write-up at the top of each file.

The first three commits contain the docstring for one module each (DEVS, Observables and Cell Space) and the fourth commit for the top level experimental init.

Docs changes only, no functional changes.

Rendered: https://mesa--2532.org.readthedocs.build/2532/apis/experimental.html

@EwoutH EwoutH added the docs Release notes label label Dec 4, 2024
@EwoutH EwoutH requested review from quaquel, Corvince and tpike3 December 4, 2024 14:55
@EwoutH
Copy link
Member Author

EwoutH commented Dec 4, 2024

Merging to include it in the 3.1.0 release, these experimental docs can always be further refined.

@EwoutH EwoutH merged commit aa839b9 into projectmesa:main Dec 4, 2024
12 of 13 checks passed

Key components:
- Cells: Active positions that can have properties and contain agents
Copy link
Member

Choose a reason for hiding this comment

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

not sure what active means here. I would suggest removing it because it suggests that cells are agents which is not the case.

- Spaces: Different cell organization patterns (grids, networks, etc.)
- PropertyLayers: Efficient property storage and manipulation

This is particularly useful for models where the environment plays an active role,
Copy link
Member

Choose a reason for hiding this comment

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

again not sure about the word active here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Release notes label
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants