britecharts / britecharts-react

Britecharts-react is a React wrapper for the Britecharts charting library. It allows the use of Britecharts charts within a React application.
http://britecharts.github.io/britecharts-react/
Apache License 2.0
113 stars 22 forks source link

Update project's documentation #146

Open davegomez opened 5 years ago

davegomez commented 5 years ago

Expected Behavior

To offer correct and complete documentation on how to use the library.

Context | Current Behavior

The documentation offers a poor description on how to use the chart components as well on how to use the responsiveness helpers as described in the issue #144.

Possible Solution

miglesiasEB commented 5 years ago

Thanks @davegomez for the issue!

Yes, it makes sense to add docs about the responsive HOC and container.

For the test data, we could provide links to the fixtures in Britecharts for now, looking into a better solution in the future.

True, a tutorial on how to use the library with different options (CommonJS, ES5 and the CDN option) would be great too.

dupski commented 5 years ago

If I have some time at the weekend I'll try to make some updates, at least to the readme, since this stuff is very fresh in my mind :)

coreysnyder commented 5 years ago

It looks like documentation hasn't been updated. I was still getting hung up on the very first example referencing a file by relative path. I think that's bad form for code examples since copy-pasting the example will never work.

 const withResponsiveness = require('../helpers/withResponsiveness.js').default;
dupski commented 5 years ago

Yeah, I guess thats the difficulty with open source being volunteer driven. Unfortunately I didn't have time to get to it that weekend and evidently no one else has :)

There's a discussion on the with responsiveness() helper in https://github.com/eventbrite/britecharts-react/issues/144 - I had the same issue

I still fully intend to contribute to this project, I've just not gone back to the charting part of my application yet :)

Golodhros commented 5 years ago

Regarding loading the modules, I think this test project can help a bit on it: https://github.com/Golodhros/britecharts-react-test-project/tree/master/src/donut