Skip to content

docs: clarify SolaraViz keyword-only model arguments#3044

Merged
quaquel merged 11 commits intomesa:mainfrom
Arjun-Sasi:solara-keyword-args-docs
Jan 25, 2026
Merged

docs: clarify SolaraViz keyword-only model arguments#3044
quaquel merged 11 commits intomesa:mainfrom
Arjun-Sasi:solara-keyword-args-docs

Conversation

@Arjun-Sasi
Copy link
Copy Markdown
Contributor

What this PR does

  • Documents that SolaraViz requires Mesa models to be instantiated using keyword-only arguments.
  • Adds a clear example showing supported vs unsupported usage.

Why this is needed

SolaraViz internally creates models using keyword arguments, which is currently undocumented and can confuse new users.

@quaquel quaquel added the docs Release notes label label Dec 30, 2025
@EwoutH EwoutH requested a review from Sahil-Chhoker January 9, 2026 10:17
@Sahil-Chhoker
Copy link
Copy Markdown
Collaborator

@Arjun-Sasi thanks for the PR and clarifying the issue, but this is not the optimal place to put this, can you add a markdown cell and add this as a warning in the tutorial file here.

@Arjun-Sasi
Copy link
Copy Markdown
Contributor Author

Arjun-Sasi commented Jan 23, 2026

Hi @Sahil-Chhoker ,Thank you for the feedback.I have now,

Added a Markdown warning cell and Updated tutorial examples (e.g., MoneyModel(...)) to use keyword arguments consistently, ensuring alignment with SolaraViz requirements.

@Sahil-Chhoker
Copy link
Copy Markdown
Collaborator

Thanks for making changes @Arjun-Sasi, looking at the ReadtheDocs build, this graph is missing:
image

and the graph you build using updated model gives this graph:
image

can you check what's wrong?

@Arjun-Sasi
Copy link
Copy Markdown
Contributor Author

Arjun-Sasi commented Jan 24, 2026

Hi @Sahil-Chhoker ,Changes made in Mark Down and example to ensure that users include All parameters when converting from positional to keyword arguments.

Copy link
Copy Markdown
Collaborator

@Sahil-Chhoker Sahil-Chhoker left a comment

Choose a reason for hiding this comment

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

LGTM!

@quaquel quaquel merged commit 9d36047 into mesa:main Jan 25, 2026
15 checks passed
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.

3 participants