-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Description
Hi,
I'm not happy about the doc because it make me confused and it SHOULD be more
- effective for mainteners
- easy to learn => more attractive
- benefit for all (less issues and more easy to evolve)
By Exemples
I show some exemple for demonstrate react-draggable will earn to upgrade the documentation. So time to change for the "greater good":
https://github.com/wix/react-native-calendars ==> Good for exemple . Basic to Advanced usage with gif (bonus)
https://github.com/react-component/slider ==> Showing tabs for props . Its effective .
In my opinion it is the best to achieve previous advice 2 rather than storybook but if you do a storybook it would be better.
Please make more easier to understand shortly and effictivly the documentation.
be concise about "DraggableCore Vs Draggable"
when write "Controlled vs. Uncontrolled", "DraggableCore" please reconsider in that format.

a concise (and clear) sentence is better than a philosophy dissertation. it is written 3 times the difference between Draggable and DraggableCore and personnally being confused.
I have not the time to read all the note: we code as dev.
I'm new trying to using this package but maybe not ... When open the demo I try to found the more basic one but thats tired me because ther is no comments or it is the Huge block of code that make me tired.
I have no pleasure to work with this doc so the only way I can continue is to experiment without the doc and spend time for learning the package , it shouldn't be .
PS: Demo
for DemoS think about the possibility to make it via codepen.io or other platform.
Demos should be one by one, for simplicity.