update build docs

Author: claudioperez

source/user/guides/compile.rst

@@ -1,2 +1,39 @@
 Compile
 =======
+
+To compile Xara from source, follow these steps:
+
+1. Download the source repository to your computer by running:
+
+   .. code-block:: bash
+      
+      git clone https://github.com/peer-open-source/xara
+      cd xara
+
+2. Create an `Anaconda environment <https://www.anaconda.com/>`__ and install the following packages:
+
+   .. tabs::
+      .. tab:: MacOS / Linux
+
+         .. code-block:: bash
+            
+            conda install -c conda-forge fortran-compiler cxx-compiler c-compiler openblas openmpi
+
+      .. tab:: Windows
+
+         .. code-block:: bash
+
+            conda install -c conda-forge cmake ninja ifx_win-64 mkl-devel conda-forge/label/mkl_rc::blas
+         
+         .. note::
+            
+            On Windows, make sure to install Visual Studio with the *"Desktop development with C++"* workload.
+
+
+3. Finally, with this environment activated, install the package with ``pip`` from inside the *xara/* directory created in step 1:
+
+   .. code-block:: bash
+      
+      python -m pip install -e .
+
+

source/user/guides/develop.rst

@@ -0,0 +1,10 @@
+Develop
+=======
+
+1. Set up a development environment by following the instructions in :ref:`compile <user/guides/compile>`.
+2. Install build dependencies by running:
+
+   .. code-block:: bash
+      
+      python -m pip install amoeba-build
+

source/user/guides/index.rst

@@ -9,6 +9,7 @@ For a great guide to Tcl programming, see `this <https://antirez.com/articoli/tc
 
    install
    compile
+   develop
    conventions
    signatures
    references

source/user/guides/install.rst

@@ -12,39 +12,11 @@ To install *xara* on Linux and new Macs, run the following command from your she
 
    python -m pip install xara
 
+Installing with ``pip`` is supported on the following platforms:
 
-On Windows and Macs with Intel processors, it is best to install from source. This takes only two additional steps:
-
-1. Download the source repository to your computer by running:
-
-   .. code-block:: bash
-      
-      git clone https://github.com/peer-open-source/xara
-      cd xara
-
-2. Create an `Anaconda environment <https://www.anaconda.com/>`__ and install the following packages:
-
-   .. tabs::
-      .. tab:: MacOS / Linux
-
-         .. code-block:: bash
-            
-            conda install -c conda-forge fortran-compiler cxx-compiler c-compiler openblas openmpi
-
-      .. tab:: Windows
-
-         .. code-block:: bash
-
-            conda install -c conda-forge cmake ninja ifx_win-64 mkl-devel conda-forge/label/mkl_rc::blas
-         
-         .. note::
-            
-            On Windows, make sure to install Visual Studio with the *"Desktop development with C++"* workload.
-
-
-3. Finally, with this environment activated, install the package with ``pip`` from inside the *xara/* directory created in step 1:
-
-   .. code-block:: bash
-      
-      python -m pip install -e .
+- Linux
+- MacOS with Apple Silicon (M1, M2, etc.)
+- Windows 
 
+On older Macs with Intel processors, it is best to install from source. 
+Please refer to the :ref:`compile <user/guides/compile>` guide for detailed instructions.