diff --git a/docs/DeveloperGuide.adoc b/docs/DeveloperGuide.adoc
index 641b637cb904..eb38da1b8e5b 100644
--- a/docs/DeveloperGuide.adoc
+++ b/docs/DeveloperGuide.adoc
@@ -781,19 +781,11 @@ Use case resumes at step 2.
 [appendix]
 == Glossary
 
-[[mainstream-os]]
-Mainstream OS
-
-....
+[[mainstream-os]] Mainstream OS::
 Windows, Linux, Unix, OS-X
-....
-
-[[private-contact-detail]]
-Private contact detail
 
-....
+[[private-contact-detail]] Private contact detail::
 A contact detail that is not meant to be shared with others
-....
 
 [appendix]
 == Product Survey