Skip to content

docs(aggregation): Document the __call__ method publicly#654

Open
ValerianRey wants to merge 5 commits intomainfrom
add-call-in-docs
Open

docs(aggregation): Document the __call__ method publicly#654
ValerianRey wants to merge 5 commits intomainfrom
add-call-in-docs

Conversation

@ValerianRey
Copy link
Copy Markdown
Contributor

@ValerianRey ValerianRey commented Apr 16, 2026

Why I named the class GramianWeighting instead of PSDMatrixWeighting: It's actually a kind of Weighting[PSDMatrix] acting specifically on gramians. The name gramian is even mentioned in the docstring.

I could have named MatrixWeighting as JacobianWeighting then, but the thing is that we often use MatrixWeighting for weightings that also work on the gramian. The only case where the weighting specifically needs a Jacobian is, I think, _NashMTLWeighting (which is not public btw).

We could be more rigorous, but I think it's a quite deep rabbit hole.

@ValerianRey ValerianRey added cc: docs Conventional commit type for changes to the documentation. package: aggregation labels Apr 16, 2026
@ValerianRey ValerianRey requested review from a team and PierreQuinton as code owners April 16, 2026 23:30
@ValerianRey ValerianRey self-assigned this Apr 16, 2026
@github-actions github-actions bot changed the title Document the __call__ method publicly docs(aggregation): Document the __call__ method publicly Apr 16, 2026
Copy link
Copy Markdown
Contributor

@PierreQuinton PierreQuinton left a comment

Choose a reason for hiding this comment

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

I like this so far, I think it could be merged essentially as is, unless you want more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cc: docs Conventional commit type for changes to the documentation. package: aggregation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants