Open drammock opened 2 years ago
Thanks for bringing this up, @drammock, I realized that I didn't like this organization back when I worked on the docs to incorporate info about the installers, but I didn't really know how (or didn't dare?) to re-organize things. Super happy to help getting this cleaned up and reorganized.
My very first intuition would be to consider the installers "the new normal", and not even bother about explaining how to get Python installed – if you need advice on how to do that, maybe you should use our standalone installers instead to begin with. So I suppose manual Python install instructions would be the first thing I'd remove without replacement.
(Just to avoid confusion, I'm talking about how to install a Python distro, not about how to manually install MNE into an existing Python install)
I haven't recently looked at the other parts of the install docs, but will try to do so in the coming days. Feel free to ping me if you don't hear back from me – I have quite a bit of stuff on my plate and need to constantly shuffle tasks, so sometimes I simply forget or de-prioritize things. A friendly poke brings it back up near the top of my to-do list, though ;)
Optimistically marking for 1.4 so we don't forget to think about taking care of parts of this in that cycle
From my view - if I just may weigh in here - something like this could make sense:
- What's the right installer for me? - mentioning also complete setups with 3D viz, Freesurfer etc, and links to that documentation
- How to install
- Test your installation
- Update your installation
- What now? -- Where to go to get started with Python, Notebooks, MNE ...
- Advanced setup
- headless server
- etc (see list above in Dan's comment)
- Overview of related tools, info about installing them, e.g. Freesurfer
Some notes from dev meeting conversation with @britta-wstnr:
I'll work on a proposal for a new outline, and post it here when it's ready for commentary.
Sounds good to me!
👌
Sorry I could not make it yesterday
ok! @drammock
For the logbook: We discussed this again at the last dev meeting with @drammock. Another thing that came up is that our contributor guide is 1) pretty long and hard to navigate and 2) hard to follow, for which I have opened another issue #11609 - linking this here as some of the documentation overlaps thematically.
Bumping milestone to 1.5 since fix changes are easy to backport (don't even require a new point release)
Our recommended installation methods have changed a lot over the past couple years, and not all parts of our install documentation have kept up. Here's an abbreviated outline of the current flow (in the order they appear):
Here are a few problems I see:
nb_conda_kernels
in the Jupyter section; freesurfer; related software like MNE-BIDS)Let's use this issue to discuss improvements to the organization / flow of the install documentation pages.
@hoechenberger