From c2cb82e70e57bc71ebfba17a9c2351d27d3ecf0f Mon Sep 17 00:00:00 2001 From: aabeatty Date: Thu, 1 Aug 2024 18:05:13 -0400 Subject: [PATCH] rewriting and typos --- .../topics/lc_creating_reltable.dita | 2 +- .../topics/lc_reuse_conrefs_in_action.dita | 30 ++++++++----------- .../topics/lc_reuse_conrefs_in_action.dita | 2 +- 3 files changed, 14 insertions(+), 20 deletions(-) diff --git a/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_reltable.dita b/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_reltable.dita index 4fd19981..00aa88b5 100644 --- a/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_reltable.dita +++ b/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_reltable.dita @@ -91,7 +91,7 @@ - Continue populating the <reltable> elment in the next topic. + Continue populating the <reltable> element in the next topic. diff --git a/en-us/course06-reuse_basic/topics/lc_reuse_conrefs_in_action.dita b/en-us/course06-reuse_basic/topics/lc_reuse_conrefs_in_action.dita index cb5e8105..202f58d4 100644 --- a/en-us/course06-reuse_basic/topics/lc_reuse_conrefs_in_action.dita +++ b/en-us/course06-reuse_basic/topics/lc_reuse_conrefs_in_action.dita @@ -13,25 +13,19 @@ -

When a DITA topic containing a conref referencing element is - processed for output (or displayed in some DITA editors), the output generator - replaces the referencing element with the referenced element and all the content of - referenced element. This includes any elements contained within the referenced - element. For example, if a referenced <p> element contains a <uicontrol> - element, the referencing <p> element is replaced by the referenced <p> element - and the <uicontrol> element contained within it. Similarly, a conref to an - <ol> element includes all the <li> elements that are contained by the <ol> - element.

-

A conref directly references a reused element using its location - and ID. The location is the path to the topic that contains the reused content, and - the id is the ID of the element to be reused. In DITA not every element requires an - ID, but it is required for any reused element.

+

Conref-ing an element inserts the element itself and its entire contents at + the location of the referencing element. For example, if a referenced paragraph + contains a <uicontrol> element, both the <p> element being referenced and the + contained <uicontrol element will be inserted at the location of the referencing element. + Or, a referenced <ol> includes all the <li> elements contained in the referenced list.

+

A conref directly references a reusable element using its + location (the path to the topic containing the reused element) and ID. In DITA not + every element requires an id, but it is required for any reused element.

+ If the element you want to reuse does not have - an ID, your DITA editor or content management system might prompt you to create an - ID for the reused element as one of the steps in creating the conref. An ID must - start with a letter, number, or underscore. - Fill in "Practice" section (continue from previous - topic) + an ID, your content management system might prompt you to create an ID for the + reused element as one of the steps in creating the conref. IDs must start with a + letter, number, or underscore.
diff --git a/en-us/course07-reuse_advanced/topics/lc_reuse_conrefs_in_action.dita b/en-us/course07-reuse_advanced/topics/lc_reuse_conrefs_in_action.dita index b0256107..c4b0677f 100644 --- a/en-us/course07-reuse_advanced/topics/lc_reuse_conrefs_in_action.dita +++ b/en-us/course07-reuse_advanced/topics/lc_reuse_conrefs_in_action.dita @@ -19,7 +19,7 @@ if a referenced paragraph contains a <uicontrol> element, the paragraph and the <uicontrol> element contained within it are inserted at the location of the referencing element. This also means that a reference to a <ol> element includes - all the <li> elelments that are contained by the <ol> element. elements that are contained by the <ol> element. "are inserted" is passive.

A conref directly references a reused element using its id and location. The location is the path to the topic that contains the reused content,