diff --git a/examples/1ptracer/doc/main.md b/examples/1ptracer/doc/main.md
index 5a6279518d563a6f3af86b1beda3393c05e999d4..f2005ef8a590e4ad9d19590257741b193d1dd41e 100644
--- a/examples/1ptracer/doc/main.md
+++ b/examples/1ptracer/doc/main.md
@@ -6,12 +6,14 @@
 
 # Part 3: Main program flow
 
-This file contains the main program flow. In this example, we solve a single-phase flow problem
-to obtain a pressure distribution in the domain. Subsequently, the distribution of volume fluxes
-is computed from that pressure distribution, which is then passed to a tracer problem to solve
-the transport of an initial contamination through the model domain.
-
-The subsequent code documentation is structured as follows:
+We want to solve a single-phase flow problem
+to obtain a pressure distribution in the domain. Subsequently, we compute a volume fluxes field
+based on the obtained pressure distribution and pass it to the tracer problem.
+Finally, we solve a transient transport problem for a tracer using the computed volume fluxes.
+This main program flow is implemented in the `main()` function
+of the program which is defined in the file `main.cc` described below.
+
+The code documentation is structured as follows:
 
 [[_TOC_]]
 
diff --git a/examples/1ptracer/doc/mainintro.md b/examples/1ptracer/doc/mainintro.md
index 7295bf55e264b64aa4b770da69e45fc715243813..99a4d831a4b5b4fed27d7be34bb15f530be5085f 100644
--- a/examples/1ptracer/doc/mainintro.md
+++ b/examples/1ptracer/doc/mainintro.md
@@ -1,10 +1,12 @@
 # Part 3: Main program flow
 
-This file contains the main program flow. In this example, we solve a single-phase flow problem
-to obtain a pressure distribution in the domain. Subsequently, the distribution of volume fluxes
-is computed from that pressure distribution, which is then passed to a tracer problem to solve
-the transport of an initial contamination through the model domain.
+We want to solve a single-phase flow problem
+to obtain a pressure distribution in the domain. Subsequently, we compute a volume fluxes field
+based on the obtained pressure distribution and pass it to the tracer problem.
+Finally, we solve a transient transport problem for a tracer using the computed volume fluxes.
+This main program flow is implemented in the `main()` function
+of the program which is defined in the file `main.cc` described below.
 
-The subsequent code documentation is structured as follows:
+The code documentation is structured as follows:
 
 [[_TOC_]]