From 1acf2b0694d5432d81fccc46f683352daf2916b2 Mon Sep 17 00:00:00 2001
From: Antonio De Lucreziis <antonio.delucreziis@gmail.com>
Date: Tue, 11 Feb 2025 00:25:34 +0100
Subject: [PATCH] updated docs

---
 README.md | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 3b40f10..2edd909 100644
--- a/README.md
+++ b/README.md
@@ -4,15 +4,39 @@
 
 ### Spack
 
+This assumes that you have spack installed and sourced. If not, you can install
+it using the following commands
+
+```bash shell
+$ git clone -c feature.manyFiles=true --depth=2 https://github.com/spack/spack.git
+
+# For bash/zsh/sh
+$ . spack/share/spack/setup-env.sh
+
+# For tcsh/csh
+$ source spack/share/spack/setup-env.csh
+
+# For fish
+$ . spack/share/spack/setup-env.fish
+```
+
+Now in the root directory of this repository, you can load the spack environment
+that contains the packages needed to build the project.
+
 ```bash shell
+# 1. Activate the local environment
 $ spack env activate ./spack-env
+
+# 2. Compile and install the packages listed in the environment
 $ spack install
+
+# optional?? it looks like cmake can still find the packages just by loding the environment using pkg-config
 $ spack load openblas openmpi petsc
 ```
 
 ### CMake
 
-To build main from main.c
+To build `main` from `main.c`
 
 ```bash shell
 $ rm -rf build