-
-
Notifications
You must be signed in to change notification settings - Fork 3.5k
Edit "Core types" descriptions #11317
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
Conversation
91d44a1 to
4d4e346
Compare
| | |span| | ``std::span`` | Represents read-only access to a contiguous array without needing to copy any data. | | ||
| | | | See `pull request description <https://github.com/godotengine/godot/pull/100293>`__ | | ||
| | | | for details. | | ||
| | | | Note that ``Span`` is designed to be a high performance API: It does not perform | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| | | | Note that ``Span`` is designed to be a high performance API: It does not perform | | |
| | | | Note that ``Span`` is designed to be a high performance API: it does not perform | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You reverted this change, was that intentional?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
When I looked at this, the discussion was already resolved, so I assumed it wasn't relevant after all. Doesn't the sentence after a semicolon begin uppercase if it's a full sentence?
Calinou
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good to me.
…` (discourage its use), `Span` (make it's clear it's low level API), and `String` (clarify UTF-32 motivation).
934cdaf to
56555c7
Compare
|
Thank you! |
Pair: MentionKeyValue.KeyValuecould get its own entry, but there is nothing much to say, andKeyValueis unlikely to be used outside of containers.RBMap: Discourage its use. We might actually phase it out fully in the future.Span: Make it clear it's low level API. People should be careful when using this.String: Clarify UTF-32 motivation. UTF-32 isn't actually more performant in all respects (it's a RAM hog), but it is simpler to work with.