From 3f0a1c1d69022cd5bcdec2b677585e58148061a1 Mon Sep 17 00:00:00 2001 From: Paul Tan Date: Wed, 6 Dec 2017 22:00:39 +0800 Subject: [PATCH] DeveloperGuide: use labeled list for glossary The glossary uses literal blocks for formatting definitions, which looks strange because literal blocks are usually used for preformatted text such as source code. Instead, let's use a labeled list, which has a formatting that is more in line with a glossary definition list. Convert the paragraph anchors into inline anchors[1], so that the items are joined into one single labeled list with two items, rather than being chopped into two separate labeled lists with one item each. [1] See http://asciidoctor.org/docs/user-manual/#anchordef for the difference between a paragraph anchor and an inline anchor. --- docs/DeveloperGuide.adoc | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) 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