You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Remove Miniconda, improve Glossary for Miniforge and conda-forge (#641)
* Better glossary tie-ins for conda stuff
* Update appendix/glossary.md
Co-authored-by: Robert Ford <50349951+r-ford@users.noreply.github.com>
---------
Co-authored-by: Robert Ford <50349951+r-ford@users.noreply.github.com>
Copy file name to clipboardExpand all lines: appendix/glossary.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,9 +32,12 @@ commit
32
32
: A snapshot of your Git repository at a specific time.
33
33
34
34
conda
35
-
: Conda is an open-source, cross-platform, language-agnostic package manager and environment management system that allows you to quickly install, run, and update packages within your work environment(s). To install `conda`, we recommend {term}`miniconda`.
35
+
: Conda is an open-source, cross-platform, language-agnostic package manager and environment management system that allows you to quickly install, run, and update packages within your work environment(s). To install conda, we recommend {term}`Miniforge`.
36
36
: See [conda documentation](https://docs.conda.io/en/latest/), particularly the [conda cheat sheet](https://docs.conda.io/projects/conda/en/latest/user-guide/cheatsheet.html), and @conda-commands in the context of Project Pythia.
37
37
38
+
conda-forge
39
+
: conda-forge is a large, community-organized collection of software packages that can be installed on a wide variety of computing platforms via the {term}`conda` package manager. It is our recommended installation source for Python itself as well as most packages in the {term}`scientific Python ecosystem`.
40
+
38
41
DevOps
39
42
: The integration and automation of practices and processes for software development and operations.
40
43
@@ -88,12 +91,9 @@ local
88
91
merge
89
92
: A specific type of commit that combines changes from two branches.
90
93
91
-
Miniconda
92
-
: [Miniconda](https://docs.conda.io/en/latest/miniconda.html) is a free minimal installer for {term}`conda`. Miniconda only comes with the {term}`conda` package management system; it is a pared-down version of the full Anaconda Python distribution.
93
-
: See @installing-conda.
94
-
95
94
Miniforge
96
-
: Miniforge is the community driven and more permissively licensed minimal installer.
95
+
: [Miniforge](https://github.com/conda-forge/miniforge) is a free minimal installer for {term}`conda`. Miniforge includes the {term}`conda` package management system, and is pre-configued to install packages from the {term}`conda-forge` repository. Miniforge is community-driven and permissively licensed.
96
+
: See @installing-conda.
97
97
98
98
[NCL](https://www.ncl.ucar.edu/)
99
99
: The NCAR Command Language (NCL) is an interpreted language designed specifically for scientific data analysis and visualization.
@@ -120,7 +120,7 @@ remote
120
120
: A repository hosted on a server such as {term}`GitHub`.
121
121
122
122
scientific Python ecosystem
123
-
: A collection of open source Python packages that support analysis, manipulation, and visualization of scientific data.
123
+
: A collection of open source {term}`Python package`s that support analysis, manipulation, and visualization of scientific data.
124
124
125
125
upstream
126
126
: The project repository from which a fork was created.
Copy file name to clipboardExpand all lines: foundations/conda.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,7 +35,7 @@ You may have encountered a few different package managers in the Python world:
35
35
-[pixi](https://pixi.prefix.dev/latest/) and [uv](https://docs.astral.sh/uv/) are newer options that are gaining popularity—well worth exploring for the adventurous learner!
36
36
- {term}`conda` is widely used for scientific computing, and this is what we recommend.
37
37
38
-
A key advantage of {term}`conda` over pip is that it manages all types of package requirements, not just Python packages. The most reliable source of up-to-date, interoperable scientific packages are found in the community-maintained `conda-forge` repository (see below).
38
+
A key advantage of {term}`conda` over pip is that it manages all types of package requirements, not just Python packages. The most reliable source of up-to-date, interoperable scientific packages are found in the community-maintained {term}`conda-forge` repository (see below).
39
39
40
40
:::{tip} TL;DR
41
41
We strongly recommend using {term}`conda` to install and manage Python and all your complex project-specific software.
@@ -45,7 +45,7 @@ We strongly recommend using {term}`conda` to install and manage Python and all y
45
45
46
46
## Installing conda
47
47
48
-
We recommend you start by [installing](https://conda-forge.org/download/)[Miniforge](https://github.com/conda-forge/miniforge). This is a specific version of the {term}`conda` package manager pre-configured to work with the `conda-forge` package repository—our recommended source for most of the packages you will need.
48
+
We recommend you start by [installing](https://conda-forge.org/download/)[Miniforge](https://github.com/conda-forge/miniforge). This is a specific version of the {term}`conda` package manager pre-configured to work with the {term}`conda-forge` package repository—our recommended source for most of the packages you will need.
49
49
50
50
You can install Miniforge by following the [instructions for your machine](https://github.com/conda-forge/miniforge#install).
51
51
@@ -57,14 +57,14 @@ A few reasons why we recommend installing Miniforge:
57
57
58
58
1. It's free, lightweight, and won't interfere with other installations on your computer.
59
59
2. It encourages you to install only the packages you need in reproducible isolated environments for specific projects. This is generally a more robust way to work with open source tools.
60
-
3. It uses `conda-forge` as the default channel for packages, which is our recommended way to get up-to-date, interoperable packages.
60
+
3. It uses {term}`conda-forge` as the default channel for packages, which is our recommended way to get up-to-date, interoperable packages.
61
61
62
-
Once you have `conda` via the Miniconda installer, the next step is to create an environment and install packages.
62
+
Once you have {term}`conda` via the {term}`Miniforge` installer, the next step is to create an environment and install packages.
63
63
64
64
:::{note}
65
65
Users looking for a full-featured commercially licensed and supported Python environment manager should take a look at [Anaconda](https://www.anaconda.com/), which may be [free for academic usage](https://www.anaconda.com/blog/update-on-anacondas-terms-of-service-for-academia-and-research).
66
66
67
-
The conda package manager and our recommended Miniforge installation are open source and free for all users.
67
+
The conda package manager and our recommended Miniforge installation are open source, community-supported and free for all users.
68
68
:::
69
69
70
70
## Creating a conda environment
@@ -137,8 +137,8 @@ Some other {term}`conda` commands that you will find useful include:
137
137
138
138
You can find lots more information in the [conda documentation](https://docs.conda.io/en/latest/) or this handy [conda cheat sheet](https://docs.conda.io/projects/conda/en/stable/user-guide/cheatsheet.html#cheatsheet).
139
139
140
-
:::{tip} What if the package you need is not available from `conda-forge`?
141
-
If the package you are trying to use (`somepackage` in these examples) only mentions `pip install somepackage` in its docs, or you tried `conda install somepackage` and conda couldn't find it, it is likely that this package is not available via the `conda-forge` channel.
140
+
:::{tip} What if the package you need is not available from {term}`conda-forge`?
141
+
If the package you are trying to use (`somepackage` in these examples) only mentions `pip install somepackage` in its docs, or you tried `conda install somepackage` and conda couldn't find it, it is likely that this package is not available via the {term}`conda-forge` channel.
142
142
143
143
As a plan B, after activating your custom conda environment you can install using pip like this:
144
144
```
@@ -167,5 +167,5 @@ We recommend installing {term}`conda` via [Miniforge](https://github.com/conda-f
Copy file name to clipboardExpand all lines: foundations/terminal.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ You'd like to learn to run Python in the terminal. Here we will cover:
21
21
22
22
## Installing Python in the Terminal
23
23
24
-
If you are running Python in the terminal, it is best to install Miniforge. You can do that by following the [instructions for your machine](https://github.com/conda-forge/miniforge).
24
+
If you are running Python in the terminal, it is best to install {term}`Miniforge`. You can do that by following the [instructions for your machine](https://github.com/conda-forge/miniforge).
25
25
26
26
:::{tip}For Windows users
27
27
When [installing Miniforge using the Windows installer](https://conda-forge.org/download/), make sure to check "Create start menu shortcuts (supported packages only)". Then in your start menu or search box, you will find the "Miniforge Prompt", where you will enter commands.
@@ -31,7 +31,7 @@ When [installing Miniforge using the Windows installer](https://conda-forge.org/
31
31
More details about conda are provided in a later section ([Installing and Managing Python with conda](conda.md)). For now, we will introduce its basic functionality.
32
32
:::
33
33
34
-
Then create a conda environment with Python installed by typing the following into your terminal:
34
+
Then create a {term}`conda` environment with Python installed by typing the following into your terminal:
0 commit comments