ENH - Update documentation and smooth developer experience

[dcmcand]

Fixes #335 Fixes #336 Fixes #337 Fixes #338

Description

Smooths developer experience and improves documentation.

This pull request:

• Eliminates using a separate docker-compose-dev.yml file by using docker-compose profiles. This eliminates confusion and duplication of code.
• Updates documentation to explain developer flows. Both using conda-store-ui from within a docker container and using it locally.
• Pins the conda-store-server version used in docker-compose and provides an environmental variable to override this version number.
• Adds the use of environment_dev.yml to local developement documenation.

Pull request checklist

• [X] Did you test this change locally?
• [X] Did you update the documentation (if required)?
• [X] Did you add/update relevant tests for this change (if required)?

Additional information

[dcmcand]

I just read through this and it does a much better job of explaining the setup. I'm hoping I can run through it to check it out first hand, but not sure when I'll have time so don't let that hold you up.

I did have one question that I'm still not clear on - will the dev setup launch conda-store server for me?

@kcpevey yes, both the local dev setup yarn run start and the dockerized version yarn run start:docker will setup all the dependencies including conda-store-server. By default, it will run conda-store-server 2023.10.1, but you can use a different image by setting the CONDA_STORE_SERVER_VERSION variable in the .env file to whatever docker image tag you want to run.