As a part of this project, I will be documenting my finds on making the tutorials and installation procedures in Matplotlib more accessible to newcomers to get them onboard our awesome repository.
This post will be an informal discussion area so that everyone in the community can review each other’s propositions.
Feel free to drop in your suggestions in this thread. I look forward to integrating your insights
My suggestions as of now are:
-
I felt that the links on this page aren’t well-typed because they include
:ref:
in the hyperlink. And I see this in a lot of places as well, which makes me wonder if this is the right way to go ahead. -
Make the following piece of code more readable for this user so that one can identify their working system and go through with the installation procedure.
sudo apt install libfreetype6-dev # Debian/Ubuntu
sudo dnf install freetype-devel # Fedora
brew install freetype # macOS with Homebrew
conda install freetype # conda, any OS
change the above to something like this
### Debian/Ubuntu
sudo apt install libfreetype6-dev
### Fedora
sudo dnf install freetype-devel
### MacOS with Homebrew
brew install freetype
### Conda / Any OS
conda install freetype
-
Have an entire, end-to-end Linux installation in one place, followed by the entire MacOS installation and then the Windows installation.
-
As there are four different places to look at for installing Matplotlib, as mentioned in this issue, I’ll be working towards consolidating them into a one-stop, easy-to-use documentation for installation.
Looking forward to your suggestions