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

Minor: Update JoinHashMap comment example to make it clearer #8154

Merged
merged 1 commit into from
Nov 15, 2023

Conversation

alamb
Copy link
Contributor

@alamb alamb commented Nov 13, 2023

Which issue does this PR close?

Part of #8130

Rationale for this change

While working on #8130 I am reading the code carefully, and I want to encode my knowledge into comments

What changes are included in this PR?

Update some example documentation to make it clearer what is going on

Are these changes tested?

Exisitng tets

Are there any user-facing changes?

No, just comments

@alamb alamb added the documentation Improvements or additions to documentation label Nov 13, 2023
@github-actions github-actions bot removed the documentation Improvements or additions to documentation label Nov 13, 2023
@@ -61,44 +61,45 @@ use hashbrown::HashSet;
///
/// ``` text
/// See the example below:
/// Insert (1,1)
///
/// Insert (10,1) <-- insert hash value 10 with row index 1
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I found the overloaded use of 1 as both a hash value and an index VERY confusing. Therefore I propose to use different values for the hash value and the index values

@alamb alamb marked this pull request as ready for review November 14, 2023 14:16
@alamb alamb changed the title Minor: Update JoinHashMap example to make it clearer Minor: Update JoinHashMap comment example to make it clearer Nov 14, 2023
@alamb alamb merged commit 77a6326 into apache:main Nov 15, 2023
23 checks passed
@alamb alamb deleted the alamb/joiN_docs branch October 18, 2024 20:45
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.

2 participants