Updating README/new developer friction

[nicolaskruchten]

Is the README in this repo up to date? I'm trying to run the instructions from the top and hitting all sorts of issues... conda can't install the requirements.txt and the Python deps aren't documented at all. yarn install throws errors relating to webpack...

Furthermore, and this might require a separate issue, but running npm run generate-python-classes mutates some of the Python, suggesting that things aren't fully in sync? Script.py gets an async element added to it. To mitigate this, I tried to revert to the last released version, but there is no tag for 0.13.2 so that's also something that's adding friction to my getting going with this repo :)

/cc @rpkyle

[chriddyp]

cc @T4rk1n @rmarren1

[T4rk1n]

Script.py gets an async element added to it. To mitigate this, I tried to revert to the last released version

That is a know issue with the component generation, it generates the props according to the python version because we have a blacklist on the keywords module. async is thus blacklisted only on python 3.7 and not on earlier python versions, so the components must be generated with python 3.7. plotly/dash#361

conda can't install the requirements.txt

Requirements made by pip freeze rarely works with conda. The python deps are only for testing and dash is needed to generate the class files on python 3.7, they should be something like:

dash
dash-renderer
dash-core-components
selenium
numpy
pandas

[rmarren1]

I'll make a quick fix for plotly/dash#361, I've been putting it off for a while and it definitely would trip up a new developer.

I was getting webpack errors before and this commit seemed to fix them: 75d441d

We should include those webpack version bumps in this bigger update:#73

[rmarren1]

Also I don't think that requirements.txt is exactly minimal, I think we can improve it. Also I like the change @T4rk1n made here: plotly/dash@61b0545, I think we should try to have that be the structure for all the repos.

[nicolaskruchten]

components must be generated with python 3.7.

Known limitations are fine, but not if they're only known by insiders :) Please keep the readme up to date!

[T4rk1n]

Known limitations are fine, but not if they're only known by insiders :) Please keep the readme up to date!

The generation bug is fixed in dash>=0.28.7

[rmarren1]

Updated this in #79