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

documentation: move num_chunks doc comment in ConvertApplyOpPattern #3770

Merged
merged 2 commits into from
Jan 20, 2025

Conversation

superlopuh
Copy link
Member

Makes the doc comment more localized and is rendered better in the online doc (upcoming).

@superlopuh superlopuh added the documentation Improvements or additions to documentation label Jan 20, 2025
@superlopuh superlopuh self-assigned this Jan 20, 2025
Copy link
Collaborator

@alexarice alexarice left a comment

Choose a reason for hiding this comment

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

Minor style comments/questions

tensor sizes it handles. Higher values may increase compute overhead but reduce size of
communication buffers when lowered.
If there are several candidate prefetch ops, the one with the largest result buffer
size is selected.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Do newlines get included in the docs or is it more like latex where single newlines are no-ops?

Copy link
Member Author

Choose a reason for hiding this comment

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

The latter, same rule with double newline, you can also add them explicitly, I think it's basically markdown for the online doc rendering (and I think for VSCode hover)

"""

num_chunks: int = 1
"""
number of chunks into which communication and computation should be split.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Should we start doc comments with capital letters?

Copy link
Member Author

Choose a reason for hiding this comment

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

Hmm, I would say yes, and should end in .

Copy link
Member Author

Choose a reason for hiding this comment

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

I wanted to minimise the changes here but actually I'll make this one.

Copy link

codecov bot commented Jan 20, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 91.25%. Comparing base (34e1697) to head (54318e4).
Report is 2 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #3770   +/-   ##
=======================================
  Coverage   91.25%   91.25%           
=======================================
  Files         461      461           
  Lines       57478    57479    +1     
  Branches     5543     5543           
=======================================
+ Hits        52454    52455    +1     
  Misses       3602     3602           
  Partials     1422     1422           

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

@superlopuh superlopuh merged commit 8d8848c into main Jan 20, 2025
16 checks passed
@superlopuh superlopuh deleted the sasha/docs/convert-csl-stencil-doc-comment branch January 20, 2025 16:16
oluwatimilehin pushed a commit to oluwatimilehin/xdsl that referenced this pull request Feb 13, 2025
…dslproject#3770)

Makes the doc comment more localized and is rendered better in the
online doc (upcoming).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants