-
Notifications
You must be signed in to change notification settings - Fork 22.9k
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
Adding some missing descriptions... #3114
Conversation
Adding some missing descriptions to match the documentation. Adding zoom.wheelDelta. Unsure of would be preferred, so I put it after zoom.filter to match the d3-zoom documentation.
API.md
Outdated
@@ -241,8 +241,8 @@ Drag and drop SVG, HTML or Canvas using mouse or touch input. | |||
* [*drag*.clickDistance](https://github.com/d3/d3-drag/blob/master/README.md#drag_clickDistance) - set the click distance threshold. | |||
* [*drag*.on](https://github.com/d3/d3-drag/blob/master/README.md#drag_on) - listen for drag events. | |||
* [*event*.on](https://github.com/d3/d3-drag/blob/master/README.md#event_on) - listen for drag events on the current gesture. | |||
* [d3.dragDisable](https://github.com/d3/d3-drag/blob/master/README.md#dragDisable) - | |||
* [d3.dragEnable](https://github.com/d3/d3-drag/blob/master/README.md#dragEnable) - | |||
* [d3.dragDisable](https://github.com/d3/d3-drag/blob/master/README.md#dragDisable) - prevents native drag-and-drop and text selection on the specified window. |
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.
Nice additions! A few notes:
- The "on the specified window" doesn't really make sense, without the context of the argument. Maybe best to leave it out.
- The other blurbs use things like "set" and "listen", rather than "sets" and "listens", so for consistency, I'd suggest making it start with "prevent".
So my final suggested wording would be:
- "prevent native drag-and-drop and text selection"
- "enable native drag-and-drop and text selection"
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.
I wasn't sure, so I just went with what it said in the d3-drag docs, but this makes sense. I'll make the change, thanks!
* [*quadtree*.remove](https://github.com/d3/d3-quadtree/blob/master/README.md#quadtree_remove) - remove a datum from a quadtree. | ||
* [*quadtree*.removeAll](https://github.com/d3/d3-quadtree/blob/master/README.md#quadtree_removeAll) - |
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.
?
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.
sim
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.
These changes look good to me. |
Adding some missing descriptions to match the documentation.
Also adding zoom.wheelDelta. Unsure of would be preferred, so I put it after zoom.filter to match the d3-zoom documentation.