DOC: Enhanced Quickstart documentation

[arkdong]

Enhanced the information existed on Quickstart documentation page, as mentioned in #1208.

TODO:

• Add unit tests and/or doctests in docstrings
• Add docstrings and API docs for any new/modified user-facing classes and functions
• New/modified features documented in docs/user-guide/*.rst
• Changes documented as a new file in changes/
• GitHub Actions have all passed
• Test coverage is 100% (Codecov passes)

[arkdong]

Hi @d-v-b and @jhamman, I've resolve your suggestion with the text and the relative links. I was unaware that the previous url links that I copied from the README.md in zarr-python repo was belonging to V2 docs, so I change them to sections links of where I think are appropriate from V3 docs. I will open a issue to fix the README.md.

One extra thing, the part of Parallel computing and synchronization in Optimizing performance was showing "Coming soon.". Does this indicate that the docs is not yet written, or that the functionality of parallel computing for V3 is not yet complete.

[arkdong]

Hi @d-v-b, do you know why some test are failed?

[d-v-b]

@arkdong not sure, the failed test is potentially flaky. I will re-run the tests, but since your changes are just in the docs I don't think we should worry too much about failing library tests

One extra thing, the part of Parallel computing and synchronization in Optimizing performance was showing "Coming soon.". Does this indicate that the docs is not yet written, or that the functionality of parallel computing for V3 is not yet complete.

IMO that "coming soon" message is not very helpful. Our recommendations for parallel computing and synchronization have not been written yet. That that content will mostly be descriptions of how to integrate zarr with external distributed computing / synchronization libraries, since we don't have any internal tools for distributed computing or synchronization at this time.

[arkdong]

@d-v-b does V3 has relatively same functionality/name for parallel computing part compare to V2?

If it is similar, we can use the part from tutorial.rst in branch support/v2

[d-v-b]

@arkdong I don't think we can simply re-use the old v2 docs on parallel computing or synchronization, because we removed some of the APIs mentioned in those docs. Those APIs were useful but we haven't added them to v3 yet.