Skip to content

fixes #92857#92859

Merged
aeschli merged 1 commit intomicrosoft:masterfrom
videlalvaro:issue_92857
Mar 18, 2020
Merged

fixes #92857#92859
aeschli merged 1 commit intomicrosoft:masterfrom
videlalvaro:issue_92857

Conversation

@videlalvaro
Copy link
Copy Markdown
Contributor

This PR fixes #92857

@aeschli
Copy link
Copy Markdown
Contributor

aeschli commented Mar 17, 2020

Not sure. A dictionary is a set. We'll keep it as is.

@aeschli aeschli closed this Mar 17, 2020
@videlalvaro
Copy link
Copy Markdown
Contributor Author

Bummer. I know this is a very low priority issue, but here's where I'm coming from

I was planning to write a blog post about how comments help with code understandability and wanted to use this case about an API that got improved thanks to a simple change.

Here's an article I wrote for the ACM explaining why I think this is important https://queue.acm.org/detail.cfm?id=3127495

And here I wrote about the importance of "paratexts" (as in Literary Theory) or code comments: https://dl.acm.org/doi/10.1145/3191697.3214326

From wikibooks:

Sets are groups of items, unordered with duplicates removed. The keys of a dictionary form a set, but each key has an associated value; these values could be duplicated within a dictionary.

I think calling that a set when we could either use dictionary or collection goes more aligned with what the code does, because set has a very specific and narrowing definition related to element uniqueness.

@aeschli
Copy link
Copy Markdown
Contributor

aeschli commented Mar 18, 2020

Let's change it to 'dictionary'. I like that suggestion.

@videlalvaro
Copy link
Copy Markdown
Contributor Author

Thanks.

Should we reopen this PR or go for a new one?

@aeschli aeschli reopened this Mar 18, 2020
@aeschli aeschli self-assigned this Mar 18, 2020
@videlalvaro
Copy link
Copy Markdown
Contributor Author

@aeschli just updated the PR, thanks!

@aeschli aeschli merged commit e38fba5 into microsoft:master Mar 18, 2020
@aeschli
Copy link
Copy Markdown
Contributor

aeschli commented Mar 18, 2020

Thanks @videlalvaro !

@github-actions github-actions bot locked and limited conversation to collaborators May 2, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

incorrect data structure description in collections.ts

2 participants