diff --git a/advect/CMakeLists.txt b/advect/CMakeLists.txt
index a49d3027..f4c18dd0 100644
--- a/advect/CMakeLists.txt
+++ b/advect/CMakeLists.txt
@@ -14,6 +14,7 @@ ${IPhreeqc_BINARY_DIR}/examples/fortran/advect/CMakeLists.txt
 advect.F90
 ic
 phreeqc.dat
+README.txt
 )
 
 if (IPHREEQC_FORTRAN_TESTING AND IPHREEQC_ENABLE_MODULE)
diff --git a/advect/README.txt b/advect/README.txt
new file mode 100644
index 00000000..dbfeb229
--- /dev/null
+++ b/advect/README.txt
@@ -0,0 +1,45 @@
+Example usage
+
+--------------------------------------------------------------------------------------
+Windows
+--------------------------------------------------------------------------------------
+Configure, build, test and install IPhreeqc
+  1. cd iphreeqc-@VERSION@-@REVISION@
+  2. mkdir _build
+  3. cd _build
+  4. cmake -S .. -B . -DCMAKE_INSTALL_PREFIX:PATH=c:/Users/charlton/iphreeqc
+  5. cmake --build . --config debug
+  6. ctest -C debug
+  7. cmake --build . --config release
+  8. ctest -C release
+  9. cmake --build . --config debug --target install
+ 10. cmake --build . --config release --target install
+
+
+Build example:
+  1. cd c:\Users\charlton\iphreeqc\examples\fortran\advect
+  2. mkdir _build
+  3. cd _build
+  4. cmake -DCMAKE_PREFIX_PATH:PATH=c:/Users/charlton/iphreeqc ..
+  5. cmake --build . --config release
+
+--------------------------------------------------------------------------------------
+Linux/macOS
+--------------------------------------------------------------------------------------
+Configure, build, test and install IPhreeqc
+  1. cd iphreeqc-@VERSION@-@REVISION@
+  2. mkdir _build
+  3. cd _build
+  4. cmake -S .. -B . -DCMAKE_INSTALL_PREFIX:PATH=/home/charlton/iphreeqc
+  5. cmake --build .
+  6. ctest
+  7. cmake --build . --target install
+
+
+Build example:
+  1. cd /home/charlton/iphreeqc/share/doc/IPhreeqc/examples/fortran/advect
+  2. mkdir _build
+  3. cd _build
+  4. cmake -DCMAKE_PREFIX_PATH:PATH=/home/charlton/iphreeqc ..
+  5. cmake --build .
+  
\ No newline at end of file