udate from Bangerth

diff --git a/examples/step-1/doc/intro.dox b/examples/step-1/doc/intro.dox
index 6e9bc68bc99d3a9a96f9e2355efc58bcb53bdceb..04d5586fe96d13829541e92c7da19984473f804b 100644 (file)
--- a/examples/step-1/doc/intro.dox
+++ b/examples/step-1/doc/intro.dox
@@ -128,11 +128,13 @@ command line, you may be interested in watching lectures 2.9 and 2.91.
 (@dealiiVideoLectureSeeAlso{2.9,2.91}) These give overviews over the command
 line and on what happens when compiling programs, respectively.
 
-Note that deal.II is actively developed, some functions were renamed
-after video lectures were ready. For example, step-1 code shown in the
-video lecture 5 has a class HyperShellBoundary which was replaced with
-SphericalManifold class later on. However, in spite of such kind of
-details the content of the lectures is still very relevant.
+Note that deal.II is actively developed, and in the course of this
+development we occasionally rename or deprecate functions or classes
+that are still referenced in these video lectures.  For
+example, step-1 code shown in the video lecture 5 has a class
+HyperShellBoundary which was replaced with SphericalManifold class
+later on. However, in spite of such kind of details the content of the
+lectures is still very relevant.
 
 <h3> What this program does </h3>