Include Doxygen build

.gitignore

@@ -71,6 +71,8 @@ doc/tex/*.gitinfo
 doc/tex/*.synctex.gz
 doc/tex/*.pdf
 doc/tex/docs/*.aux
+doc/doxyoutput/
+doc/api/
 
 ### Ignore IDE files ###
 .vs/

doc/README.md

@@ -1,21 +1,44 @@
-## CADET Documentation
+# CADET Documentation
 
+This document provides instructions for building CADET documentation locally and for all releases and branches.
 
-To build the documentation locally, install sphinx and other dependencies by running
+## Prerequisites
 
-```
-pip install -r requirements.txt
+Ensure you have [mamba](https://mamba.readthedocs.io/en/latest/installation.html) installed on your system.
 
-```
+## Building Documentation Locally
+
+1. **Navigate to the `doc` folder**:
+
+    ```sh
+    cd <root>/doc/
+    ```
+
+2. **Create and activate the documentation environment**:
 
-Then, in the `doc` folder run:
+    ```sh
+    mamba env create -f ./environment.yml
+    mamba activate cadet-core-docs
+    ```
 
-`sphinx-build -b html . build` 
+3. **Build the documentation**:
 
-The output is in the `build` directory and can be opened with any browser.
+    ```sh
+    sphinx-build -b html . build
+    ```
+
+    The output is in the `build` directory and can be opened with any browser.
+
+## Building Documentation for All Releases and Branches
 
 To build the documentation for all releases and the master branch, run:
 
-`sphinx-multiversion ./ ./build/`. 
+```sh
+sphinx-multiversion ./ ./build/ -D 'exhale_args.containmentFolder=${sourcedir}/api'
+```
 
-Any changes to the documentation will automatically be pushed to the github-pages repository (https://github.com/cadet/cadet.github.io) using github actions.
+On Windows, use the following command:
+
+```powershell
+sphinx-multiversion ./ ./build/ -D exhale_args.containmentFolder=${sourcedir}/api
+```