Add docs

[GeorgianaElena]

This puts together some of the docs we already have.

• I'd like to add some screenshots too.
• Document a more complex setup too (with a Dockerfile), and give an example repo: moved to Document customizations that require their own Dockerfile #3

Reference: 2i2c-org/infrastructure#631

[choldgraf]

hey @GeorgianaElena - would you like 👀 or still want to finish stuff up first? The PR is not in "draft mode", but the title says "WIP" so I am not sure which to believe :-)

[choldgraf]

This looks great to me - just need to add in the images etc and I think it is a great start. We should ask someone to try out the instructions and see if it works!

[GeorgianaElena]

Thanks @choldgraf! I added the screenshots now too.

What do you think if instead of tacking in this PR this:

Document a more complex setup too (with a Dockerfile), and give an example repo

I open an issue in this repo and tackle this task in another PR?

[sgibson91]

I have a few suggestions to clarify the text a little bit, but this looks great!!

[sgibson91]

Document a more complex setup too (with a Dockerfile), and give an example repo

I open an issue in this repo and tackle this task in another PR?

+1 but I think it would be useful to have another template repo that looks like https://github.com/2i2c-org/coessing-image for Pangeo-based images

[choldgraf]

This looks good to me after @sgibson91's suggestions are resolved. Thanks @GeorgianaElena for working this out! I think it will be very helpful for folks who want that extra control over their environment.

I've opened up #3 to discuss the more advanced use-cases and Dockerfiles. Perhaps we can take conversation about that over there? @sgibson91 one thing I am trying to understand is when you really need a dockerfile vs when you can get away with postBuild scripts and such. It would be helpful for us to converge a bit on best-practices there.

[damianavila]

LGTM (modulo @sgibson91 comments and suggestions are addressed).

[GeorgianaElena]

Thanks everyone! ☀️

[choldgraf]

thanks for this great work @GeorgianaElena :-)