Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update install docs #3350

Merged
merged 6 commits into from
Jun 23, 2021
Merged

Conversation

neutrinoceros
Copy link
Member

@neutrinoceros neutrinoceros commented Jun 12, 2021

PR Summary

fix #3244

There is a lot going on in our installation guide and I'm trying to reduce it as much as I can.
I'm going to assume readers know a way to setup isolated envs instead of trying to teach them various tools all at once.
I will probably need some assistance in updating Conda-related instructions since I haven't used it in a while, but I'll try my best to go as far as possible without help.

Here are my guidelines for this work:

  • avoid touching the all-in-one installation script if I can.
  • simplify/reuse existing docs as much as possible (deduplicate information)
  • provide minimal yet usable instructions for a narrow subset of possible scenarios (using pip or conda to install from source or stable releases).

I have separated the general instructions from the ones specific to the all-in-one installation script, because this part alone makes up for more than half the material and IMHO should only be used as a last-resort or a quick-and-dirty way to setup yt for a workshop. While the diff is pretty large, most of it comes from that separation, and in general, most of the text is rearranged or repurposed, but I'm not really adding much new material.

Note on Cartopy:
it seems to me that users who need cartopy+yt are the most likely to want a conda install, since it's (in)famously not trivial to install with pip. I'll need to address this at the top level of the document but I still want to keep it as brief as possible.

@neutrinoceros neutrinoceros added docs yt-4.0 feature targeted for the yt-4.0 release labels Jun 12, 2021
@neutrinoceros neutrinoceros force-pushed the update_install_docs branch 4 times, most recently from 63b13e1 to 371892f Compare June 12, 2021 20:07
@matthewturk
Copy link
Member

I think I am in agreement with the goals of this reworking. I am going to provide comments now.

doc/source/installing.rst Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
doc/source/install_script.rst Outdated Show resolved Hide resolved
doc/source/install_script.rst Outdated Show resolved Hide resolved
doc/source/installing.rst Outdated Show resolved Hide resolved
doc/source/installing.rst Outdated Show resolved Hide resolved
@neutrinoceros neutrinoceros marked this pull request as ready for review June 19, 2021 20:59
Co-authored-by: Matthew Turk <matthewturk@gmail.com>
@matthewturk
Copy link
Member

I think with a second review we should consider merging this.

Copy link
Member

@brittonsmith brittonsmith left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A vast simplification. Great work. Just the one minor comment.

doc/source/visualizing/plots.rst Outdated Show resolved Hide resolved
neutrinoceros and others added 2 commits June 22, 2021 18:01
Co-authored-by: Britton Smith <brittonsmith@gmail.com>
@jzuhone
Copy link
Contributor

jzuhone commented Jun 23, 2021

Since the only failure is fixed in #3373 I'm going to merge this.

doc/source/faq/index.rst Outdated Show resolved Hide resolved
doc/source/faq/index.rst Outdated Show resolved Hide resolved
Copy link
Contributor

@jzuhone jzuhone left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a couple of minor things I saw for consistency, otherwise good!

Co-authored-by: John ZuHone <jzuhone@gmail.com>
@jzuhone jzuhone merged commit bea2964 into yt-project:main Jun 23, 2021
@neutrinoceros neutrinoceros deleted the update_install_docs branch June 23, 2021 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs yt-4.0 feature targeted for the yt-4.0 release
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update installation documentation
4 participants