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

Use 'i' and 'k' to better distinguish variables in an example #713

Merged
merged 1 commit into from
Nov 4, 2020
Merged

Use 'i' and 'k' to better distinguish variables in an example #713

merged 1 commit into from
Nov 4, 2020

Conversation

alexwlchan
Copy link
Contributor

It took me a moment of staring at this example to realise that i and j were actually different variables. They're not very different in the monospaced font!

I'm hoping that i and k will make them stand out more, and this example easier to read.

(Most letters seem to have a use already in this file, or I'd have picked an even more different pair of letters.)

Pull Request Check List

This is just a friendly reminder about the most common mistakes. Please make sure that you tick all boxes. But please read our contribution guide at least once, it will save you unnecessary review cycles!

If an item doesn't apply to your pull request, check it anyway to make it apparent that there's nothing left to do. If your pull request is a documentation fix or a trivial typo, feel free to delete the whole thing.

  • Added tests for changed code.
  • New features have been added to our Hypothesis testing strategy.
  • Changes or additions to public APIs are reflected in our type stubs (files ending in .pyi).
    • ...and used in the stub test file tests/typing_example.py.
  • Updated documentation for changed code.
    • New functions/classes have to be added to docs/api.rst by hand.
    • Changes to the signature of @attr.s() have to be added by hand too.
    • Changed/added classes/methods/functions have appropriate versionadded, versionchanged, or deprecated directives. Find the appropriate next version in our __init__.py file.
  • Documentation in .rst files is written using semantic newlines.
  • Changes (and possible deprecations) have news fragments in changelog.d.

If you have any questions to any of the points above, just submit and ask! This checklist is here to help you, not to deter you from contributing!

@hynek hynek merged commit cd2f886 into python-attrs:master Nov 4, 2020
@hynek
Copy link
Member

hynek commented Nov 4, 2020

Thanks for improving our docs!

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

Successfully merging this pull request may close these issues.

None yet

2 participants