Skip to content

Chaos when learning react-draggable as Dev #658

@c0ncentus

Description

@c0ncentus

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.
image

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions