DOC: update installation page

[lucascolley]

We just overhauled the SciPy installation page at https://scipy.org/install/, including:

• creating a separate beginner guide for those who may not be comfortable with using a terminal or happy to learn to use a package manager
• recommending project-based workflows to users who do not consider themselves beginners (uv and pixi)
• modernising instructions for installing with pip or conda

You may wish to do similar things for https://numpy.org/install/. Feel free to copy anything I wrote on the SciPy page!

[mattip]

It might be nice to set this up as a tab-based page with a tab for each installation method. This would emphasize that they are equivalent alternatives.

[Musharraffaijaz]

Hi,
@lucascolley @mattip I'm working on a PR that would involve making some lengthier commits to the installation instructions in the install.md file.
If thats fine, I'd be happy to create the PR for your review.

Thanks,

[Musharraffaijaz]

@mattip what about this? Since in markdowns, there is no option for Tabs and we can get tabs in MDX instead, so instead of a tab based navigation, how about the tabular one?

[mattip]

If you want you could try something like this for tabs. I think the tabular (table) view wastes too much valuable space.

[Musharraffaijaz]

The PR updated the installation page with tab based navigation #608 resolves this issues

[lucascolley]

Hi @Musharraffaijaz - it looks like your PR affects scipy.org. This issue was about potential updates to numpy.org.

I'll have a look at your PR to see whether it looks like an improvement for SciPy! But I don't think it would close this issue.

[jarrodmillman]

Here is how you use tabs with the theme: https://theme.scientific-python.org/user_guide/web-components/#tabs

[jarrodmillman]

Here's more information: https://theme.scientific-python.org/shortcodes/#tabs

[Musharraffaijaz]

We just overhauled the SciPy installation page at https://scipy.org/install/, including:

• creating a separate beginner guide for those who may not be comfortable with using a terminal or happy to learn to use a package manager
• recommending project-based workflows to users who do not consider themselves beginners (uv and pixi)
• modernising instructions for installing with pip or conda

You may wish to do similar things for https://numpy.org/install/. Feel free to copy anything I wrote on the SciPy page!

@lucascolley I have used the same tabs approach which Mattip suggested, and what I understood from the issue is that there are 5 installation methods for scipy, which I tried to separate using these tabs. The tabs are I had used are similiar to what @jarrodmillman has suggested, but scipy

[Musharraffaijaz]

@lucascolley @mattip what could be the improvements to the https://numpy.org/install/ page? I mean do we have to try the similiar tab-based navigation as we did in the scipy/install page?

[mattip]

It would be nice to refactor the NumPy pages to be much like the SciPy page after that PR lands.

[Musharraffaijaz]

It would be nice to refactor the NumPy pages to be much like the SciPy page after that PR lands.

@mattip Thank you for the reply, I will begin working on the task immediately. While that PR has been approved, I would greatly appreciate it if you could conduct a final review to facilitate its merge. Once that is complete, I will commence work on the NumPy integration.

[Musharraffaijaz]

@mattip @lucascolley @jarrodmillman @stefanv, wanted to know, how to approach here https://numpy.org/install

A Tab for (PIP and Conda), then after recommendations a tab for (Beginners and Advanced), then the similiar for Python package management (Pip, conda & Reproducible installs)?
Is this the intended format/flow?

[mattip]

I'm not sure, but I think I prefer the layout 1:1 from the https://scipy.org/install/ page instead of what we have. What do others think?

[melissawm]

I agree, the scipy page looks awesome and the contents should be very similar so I'd vote to follow that.

[Musharraffaijaz]

@mattip @melissawm thank you for your review, could you please check the PR "Update the numpy installation page with tab based navigation" which tries to update the Numpy installation page.

[Musharraffaijaz]

@lucascolley @mattip could you please review this PR #832

[melissawm]

Hi @Musharraffaijaz - sorry for the delay, it looks like we are all a bit busy but we'll make sure to come back to this issue when we can. Thanks for the patience!

[Musharraffaijaz]

@melissawm sure, sorry for any inconvenience caused.

[Musharraffaijaz]

I guess this issue is now resolved, @mattip do you consider any other project or issue where I could contribute to?

[mattip]

Thanks for fixing this. As for more issues, you could look at the ones in numpy and scipy that are marked "DOC".

[Musharraffaijaz]

Alright, thanks.