From f8bcc1ba93f7e2a3c4112b2b5f53ba71664d932e Mon Sep 17 00:00:00 2001
From: Dan Allen <dan.j.allen@gmail.com>
Date: Wed, 9 Dec 2020 03:14:54 -0700
Subject: [PATCH] resolves #21 document where anchor must be placed for item in
 dlist (PR #22)

---
 modules/attributes/examples/id.adoc | 12 ++++++++++--
 modules/attributes/pages/ids.adoc   | 12 ++++++++++--
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/modules/attributes/examples/id.adoc b/modules/attributes/examples/id.adoc
index 7243c2d..24463d0 100644
--- a/modules/attributes/examples/id.adoc
+++ b/modules/attributes/examples/id.adoc
@@ -27,11 +27,19 @@ anchor:bookmark-c[]Use a cross reference to link to this location.
 [[anchor-point]]* list item text
 // end::anchor-wrong[]
 
-// tag::anchor-list[]
+// tag::anchor-list-item[]
 * First item
 * [[step2]]Second item
 * Third item
-// end::anchor-list[]
+// end::anchor-list-item[]
+
+// tag::anchor-dlist-item[]
+[[cpu,CPU]]Central Processing Unit (CPU)::
+The brain of the computer.
+
+[[hard-drive]]Hard drive::
+Permanent storage for operating system and/or user files.
+// end::anchor-dlist-item[]
 
 // tag::anchor-header[]
 === Version 4.9 [[version-4_9]]
diff --git a/modules/attributes/pages/ids.adoc b/modules/attributes/pages/ids.adoc
index a290517..42402d9 100644
--- a/modules/attributes/pages/ids.adoc
+++ b/modules/attributes/pages/ids.adoc
@@ -114,7 +114,7 @@ The anchors in the text get replaced with invisible anchor points in the output.
 
 For example, you would not put an anchor in front of a list item:
 
-.Wrong position for an anchor ID in front of a list item.
+.Incorrect position for an anchor ID in front of a list item
 [source]
 ----
 include::example$id.adoc[tag=anchor-wrong]
@@ -125,7 +125,15 @@ Instead, you would put it at the very start of the text of the list item:
 .Define an inline anchor on a list item
 [source]
 ----
-include::example$id.adoc[tag=anchor-list]
+include::example$id.adoc[tag=anchor-list-item]
+----
+
+For a description list, the anchor must be placed at the start of the term:
+
+.Define an inline anchor on a description list item
+[source]
+----
+include::example$id.adoc[tag=anchor-dlist-item]
 ----
 
 Here's how you can define the ID for a section using an inline anchor:
-- 
GitLab