Add Troublshooting section?

dandi / handbook

Handbook for interacting with the DANDI archive.

https://www.dandiarchive.org/handbook/

6 stars 12 forks source link

Add Troublshooting section? #128

Open yarikoptic opened 5 months ago

yarikoptic commented 5 months ago

which would likely just lead to our https://github.com/dandi/helpdesk/discussions .

one of the common cases could be outdated "system wide" Python which we no longer support, and then them following pip install dandi we instruct them to do in our UI

kabilar commented 5 months ago

I agree that we should add an explicit section to the left navigation. How about we take the Where to Get Help section, simplify it, and use this content to create a new User Support section?

one of the common cases could be outdated "system wide" Python which we no longer support, and then them following pip install dandi we instruct them to do in our UI

Sorry, not sure what you mean by the above statement in this context.

yarikoptic commented 5 months ago

on HPC, OSX etc system wide python might already be not supported "upstream". E.g. 3.7 is no longer supported by Python and by us. But our download instructions on DLP say

NB update proposed in https://github.com/dandi/dandi-archive/pull/1919

Hence people would try to do that pip install and it might either fail or just install some older version of dandi which would not be working.

kabilar commented 5 months ago

Good catch, @yarikoptic. In addition to your DLP pull request above, I have updated the sections in the docs here: #129.