move section to software/software

docs/cheaha/open_ondemand/ood_jupyter.md

@@ -111,22 +111,17 @@ While launching an OOD HPC Desktop Job or any OOD Applications, if the user gets
 
 Using `conda init` causes a block of code automatically inserted into the `.bashrc` file in your `$HOME` directory. This code block may interfere with the proper functioning of various OOD applications, resulting in a VNC error. To address this issue, it is recommended to follow the instructions outlined in the [FAQ entry](https://ask.cyberinfrastructure.org/t/why-do-i-get-an-error-when-launching-an-open-ondemand-hpc-interactive-session/2496).
 
-### Pip Installs Packages Outside of Environment
+### Installing Pip Packages Outside of Your Environments
 
-When installing packages within a `conda` environment using `pip`, it's crucial to ensure that you install `pip` within the same conda environment and use `pip` from that environment. If `pip` is used outside of `conda` or within an environment without `pip` installed, the packages are installed to `~/.local`. This can lead to unexpected package conflicts, as Python loads packages from `~/.local` before loading from `conda` environments, and shows the following error,
-
-```bash
-Requirement already satisfied: numpy in /home/$USER/.local/lib/python3.11/site-packages (1.26.3)
-```
+<!-- markdownlint-disable MD046 -->
+!!! danger
 
-For the above case, resolving errors involve deleting the `~/.local` directory.
+    Using `pip install` without loading Miniforge3 will cause hard-to-diagnose errors and broken workflows.
 
-Here's an example of the correct procedure for installing `pip` packages within a `conda`:
+    Using `pip install` in the `base` environment will cause the same hard-to-diagnose errors and broken workflows.
 
-1. Load the `Miniforge` module using `module load Miniforge3`.
-1. Create or activate the desired `conda` environment. Please refer to the [`conda` documentation](../../workflow_solutions/using_conda.md#create-an-environment)
-1. Install `pip` within the `conda` environment using `conda install pip` or `conda install python`. `pip` and `python` are packaged together, installing one will always install the other.
-1. Use `pip` when this `conda` environment is active to install packages. Please refer to [Installing packages with `pip`](../../workflow_solutions/using_conda.md#installing-packages-with-pip)
+    Read more about this issue, and how to resolve it, [here](../software/software.md#installing-pip-packages-outside-of-your-environments).
+<!-- markdownlint-disable MD046 -->
 
 ### Tensorflow and PyTorch GPU issues
 

docs/cheaha/software/software.md

@@ -55,11 +55,28 @@ Once you have loaded the Miniforge module, `conda` on Cheaha works similarly to
 
     Using `pip install` in the `base` environment will cause the same hard-to-diagnose errors and broken workflows.
 
-    Read more about this issue, and how to resolve it, [here](../open_ondemand/ood_jupyter.md#pip-installs-packages-outside-of-environment).
+    Read more about this issue, and how to resolve it, [here](#installing-pip-packages-outside-of-your-environments).
 <!-- markdownlint-enable MD046 -->
 
 For more information on usage with examples, see [`conda` Environments](../../workflow_solutions/using_conda.md). Need some hands-on experience? You can find instructions on how to install PyTorch and TensorFlow using `conda` in this [tutorial](../tutorial/pytorch_tensorflow.md).
 
+### Installing Pip Packages Outside of Your Environments
+
+When installing packages within a `conda` environment using `pip`, it's crucial to ensure that you install `pip` within the same conda environment and use `pip` from that environment. If `pip` is used outside of `conda` or within an environment without `pip` installed, the packages are installed to `~/.local`. This can lead to unexpected package conflicts, as Python loads packages from `~/.local` before loading from `conda` environments, and shows the following error,
+
+```bash
+Requirement already satisfied: numpy in /home/$USER/.local/lib/python3.11/site-packages (1.26.3)
+```
+
+For the above case, resolving errors involve deleting the `~/.local` directory.
+
+Here's an example of the correct procedure for installing `pip` packages within a `conda`:
+
+1. Load the `Miniforge` module using `module load Miniforge3`.
+1. Create or activate the desired `conda` environment. Please refer to the [`conda` documentation](../../workflow_solutions/using_conda.md#create-an-environment)
+1. Install `pip` within the `conda` environment using `conda install pip` or `conda install python`. `pip` and `python` are packaged together, installing one will always install the other.
+1. Use `pip` when this `conda` environment is active to install packages. Please refer to [Installing packages with `pip`](../../workflow_solutions/using_conda.md#installing-packages-with-pip)
+
 ## Singularity Containers
 
 Containers are a very useful resource for installing software without needing administrator permission. Please read the full documentation about singularity and containers on our [main Singularity page](../../workflow_solutions/getting_containers.md#containers-on-cheaha).

docs/workflow_solutions/using_conda.md

@@ -119,7 +119,7 @@ When building a `conda` environment, prefer to get all of your packages through
 <!-- markdownlint-disable MD046 -->
 !!! important
 
-    Make sure `pip` is installed within the `conda` environment and use it for installing packages within the `conda` environment to prevent [Pip related issues](../cheaha/open_ondemand/ood_jupyter.md#pip-installs-packages-outside-of-environment).
+    When using `conda` and `pip` on Cheaha, make sure you are using a custom `conda` environment and that `pip` is installed before installing `pip` packages to prevent severe [`pip` related issues](../cheaha/software/software.md#installing-pip-packages-outside-of-your-environments).
 <!-- markdownlint-disable MD046 -->
 
 <!-- markdownlint-disable MD046 -->