diff --git a/docs/devguide.html.in b/docs/devguide.html.in
index 409952e4f7234e557d0607eb3854cb1320c95e1b..6c51c36f64b4082baba72881206d94e7089d201f 100644
--- a/docs/devguide.html.in
+++ b/docs/devguide.html.in
@@ -4,16 +4,16 @@
     <h1>libvirt Application Development Guide</h1>
 
     <p>
-      This is both a guide to developing with libvirt, and a useful
-      reference document.  It is a work in progress, contributed to by the
-      members of the libvirt team and being authored by a professional
-      author.
+      The guide is both a learning tool for developing with libvirt and an
+      API reference document. It is a work in progress, composed by a
+      professional author from contributions written by members of the
+      libvirt team.
     </p>
 
     <p>
-      Contributors to this are <b>VERY</b> welcome, so if you'd like to
-      get your name in this and demonstrate your virtualisation prowess,
-      contributing solidly to the content here will do it. :)
+      Contributions to the guide are <b>VERY</b> welcome. If you'd like to get
+      your name on this and demonstrate your virtualisation prowess, a solid
+      contribution to the content here will do it. :)
     </p>
 
     <h2>Browsable online</h2>
diff --git a/docs/downloads.html.in b/docs/downloads.html.in
index 66b99e11dee5a0f692b3a2125fff72ec0927b472..2ce10486b0a60eaabf59becfbb4385c5d1980d9f 100644
--- a/docs/downloads.html.in
+++ b/docs/downloads.html.in
@@ -49,16 +49,16 @@
     <h1>libvirt Application Development Guide</h1>
 
     <p>
-      This is both a guide to developing with libvirt, and a useful
-      reference document.  It is a work in progress, contributed to by the
-      members of the libvirt team and being authored by a professional
-      author.
+      The guide is both a learning tool for developing with libvirt and an
+      API reference document. It is a work in progress, composed by a
+      professional author from contributions written by members of the
+      libvirt team.
     </p>
 
     <p>
-      Contributors to this are <b>VERY</b> welcome, so if you'd like to
-      get your name in this and demonstrate your virtualisation prowess,
-      contributing solidly to the content here will do it. :)
+      Contributions to the guide are <b>VERY</b> welcome. If you'd like to get
+      your name on this and demonstrate your virtualisation prowess, a solid
+      contribution to the content here will do it. :)
     </p>
 
     <h2>Downloadable PDF</h2>