From 8eb662368a15d074babfcadc05ba5fcc868cdd7a Mon Sep 17 00:00:00 2001 From: bburns-hp Date: Thu, 12 Jan 2023 16:40:20 -0700 Subject: [PATCH 1/4] Updated shortdesc for natural language --- .../technicalContent/glossAbbreviation.dita | 3 +-- .../langRef/technicalContent/glossAcronym.dita | 3 +-- .../langRef/technicalContent/glossAlt.dita | 3 +-- .../technicalContent/glossAlternateFor.dita | 8 +++----- .../langRef/technicalContent/glossBody.dita | 8 ++------ .../langRef/technicalContent/glossProperty.dita | 3 +-- .../langRef/technicalContent/glossdef.dita | 3 +-- .../langRef/technicalContent/glossentry.dita | 15 +++------------ .../langRef/technicalContent/glossterm.dita | 8 +++----- 9 files changed, 16 insertions(+), 38 deletions(-) diff --git a/specification/langRef/technicalContent/glossAbbreviation.dita b/specification/langRef/technicalContent/glossAbbreviation.dita index cba740ef..639d952f 100644 --- a/specification/langRef/technicalContent/glossAbbreviation.dita +++ b/specification/langRef/technicalContent/glossAbbreviation.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossAbbreviation</xmlelement> - The glossAbbreviation element provides an abbreviated form of - the term that is contained in a glossterm element. + The glossary abbreviation element provides an abbreviated form of the term that is contained in a glossary term element. diff --git a/specification/langRef/technicalContent/glossAcronym.dita b/specification/langRef/technicalContent/glossAcronym.dita index 26fcbc21..b4989142 100644 --- a/specification/langRef/technicalContent/glossAcronym.dita +++ b/specification/langRef/technicalContent/glossAcronym.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossAcronym</xmlelement> - The glossAcronym element defines an acronym for the term that - is defined in the glossterm element. + The glossary acronym element defines an acronym for the term that is defined in the glossary term element. diff --git a/specification/langRef/technicalContent/glossAlt.dita b/specification/langRef/technicalContent/glossAlt.dita index 0546c6c9..36dc1823 100644 --- a/specification/langRef/technicalContent/glossAlt.dita +++ b/specification/langRef/technicalContent/glossAlt.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossAlt</xmlelement> - The glossAlt element contains a variant term for the preferred - term that is defined in the glossterm element. + The glossary alternative element contains a variant term for the preferred term that is defined in the glossary term element. diff --git a/specification/langRef/technicalContent/glossAlternateFor.dita b/specification/langRef/technicalContent/glossAlternateFor.dita index 0b4496f2..77bf71f4 100644 --- a/specification/langRef/technicalContent/glossAlternateFor.dita +++ b/specification/langRef/technicalContent/glossAlternateFor.dita @@ -3,11 +3,9 @@ "reference.dtd"> <xmlelement>glossAlternateFor</xmlelement> -The glossAlternateFor element indicates when a variant term has - a relationship to another variant term in addition to the preferred term.Does it "indicate when a variant term has a relationship" - or does it specify that there is a relationship with a specific other - term? +The glossary alternate for element indicates when a variant term has a relationship to another variant term in addition to the preferred term.Does it "indicate when a variant term has a relationship" or does it specify that there is a relationship with a specific other term? glossAlternateFor glossariesvariant terms diff --git a/specification/langRef/technicalContent/glossBody.dita b/specification/langRef/technicalContent/glossBody.dita index 873e635d..6869bf48 100644 --- a/specification/langRef/technicalContent/glossBody.dita +++ b/specification/langRef/technicalContent/glossBody.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossBody</xmlelement> -The glossBody element is used to provide details about a - glossary term, such as part of speech or additional forms of the term. +The glossary body element is used to provide details about a glossary term, such as part of speech or additional forms of the term. glossBody glossentry @@ -13,10 +12,7 @@
Specialization hierarchy -

The glossBody element is specialized from - conbody; it is defined in the glossary entry module. The - conbody element is specialized from - body; it is defined in the concept module.

+

The glossBody element is specialized from conbody. It is defined in the glossary entry module. The conbody element is specialized from body. It is defined in the concept module.

Attributes diff --git a/specification/langRef/technicalContent/glossProperty.dita b/specification/langRef/technicalContent/glossProperty.dita index b72fa0c4..de42b01d 100644 --- a/specification/langRef/technicalContent/glossProperty.dita +++ b/specification/langRef/technicalContent/glossProperty.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossProperty</xmlelement> -The glossProperty element specifies additional details about the - preferred term or its subject, such as the gender of a noun. +The glossary property element specifies additional details about the preferred term or its subject, such as the gender of a noun. glossariesextension points diff --git a/specification/langRef/technicalContent/glossdef.dita b/specification/langRef/technicalContent/glossdef.dita index fd33a02d..29c33b08 100644 --- a/specification/langRef/technicalContent/glossdef.dita +++ b/specification/langRef/technicalContent/glossdef.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossdef</xmlelement> -The glossdef element specifies the definition of one sense of a - term. +The gloss definition element specifies the definition of one sense of a term. glossariesdefinitions diff --git a/specification/langRef/technicalContent/glossentry.dita b/specification/langRef/technicalContent/glossentry.dita index e1a50afb..a8c0870f 100644 --- a/specification/langRef/technicalContent/glossentry.dita +++ b/specification/langRef/technicalContent/glossentry.dita @@ -3,9 +3,7 @@ "reference.dtd"> <xmlelement>glossentry</xmlelement> - The glossentry element defines a single sense of a glossary - term. Glossary entries for different term senses can be reused independently of one - another. + The glossary entry element defines a single sense of a glossary term. Glossary entries for different term senses can be reused independently of one another. @@ -19,21 +17,14 @@
Processing expectations -

The recommended (but not required) book processing is to sort and group glossary entries - based on the localized term so a back-of-the-book glossary can contain a collated list of - terms with the definitions of the individual senses of each term indented under the term. - The glossary can have a different organization in different languages depending on the - translation of the terms.

+

The recommended book processing is to sort and group glossary entries based on the localized term so a back-of-the-book glossary can contain a collated list of terms with the definitions of the individual senses of each term indented under the term. The glossary can have a different organization in different languages depending on the translation of the terms.

One possible implementation of a glossary in online processing is to associate a hotspot for mentions of terms in term elements and display the definition on hover or click.

Specialization hierarchy -

The glossentry element is specialized from - concept; it is defined in the glossary entry module. The - concept element is specialized from - topic; it is defined in the concept module.

+

The glossentry element is specialized from concept. It is defined in the glossary entry module. The concept element is specialized from topic. It is defined in the concept module.

diff --git a/specification/langRef/technicalContent/glossterm.dita b/specification/langRef/technicalContent/glossterm.dita index 049b47f7..76150544 100644 --- a/specification/langRef/technicalContent/glossterm.dita +++ b/specification/langRef/technicalContent/glossterm.dita @@ -3,11 +3,9 @@ "reference.dtd"> <xmlelement>glossterm</xmlelement> -The glossterm element specifies the preferred term that is - associated with a definition of a sense. If the same term has multiple senses, create a - separate glossentry topic for each sense.associated with a definition of a "sense"? I - think we need to clear that up. +The glossary term element specifies the preferred term that is associated with a definition of a sense. If the same term has multiple senses, create a separate glossary entry topic for each sense.associated with a definition of a "sense"? I think we need to clear that up. glossariestermsglossentry elementsglossterm From 649c23e364d82f2d6f7f753a8a7281b489a24878 Mon Sep 17 00:00:00 2001 From: bburns-hp Date: Fri, 13 Jan 2023 13:53:19 -0700 Subject: [PATCH 2/4] Updated shortdesc elements and other light edits --- .../langRef/technicalContent/glossAlternateFor.dita | 10 ++-------- .../langRef/technicalContent/glossScopeNote.dita | 10 +++------- .../langRef/technicalContent/glossStatus.dita | 5 +---- .../langRef/technicalContent/glossSymbol.dita | 3 +-- .../langRef/technicalContent/glossSynonym.dita | 3 +-- specification/langRef/technicalContent/glossUsage.dita | 3 +-- 6 files changed, 9 insertions(+), 25 deletions(-) diff --git a/specification/langRef/technicalContent/glossAlternateFor.dita b/specification/langRef/technicalContent/glossAlternateFor.dita index 77bf71f4..28e42c59 100644 --- a/specification/langRef/technicalContent/glossAlternateFor.dita +++ b/specification/langRef/technicalContent/glossAlternateFor.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossAlternateFor</xmlelement> -The glossary alternate for element indicates when a variant term has a relationship to another variant term in addition to the preferred term.The glossAlternateFor element indicates when a variant term has a relationship to another variant term in addition to the preferred term.Does it "indicate when a variant term has a relationship" or does it specify that there is a relationship with a specific other term? @@ -15,13 +15,7 @@
Usage information -

The glossAlternateFor element is available inside the - glossAlt element, which is a container that provides a variant - for the primary glossentry term. In some cases, the variant might - also be an alternate for another term. In the example below, the abbreviation "stick" is a - variant of the primary term (USB flash drive). The - glossAlternateFor element indicates that "stick" is also a - variant of the synonym "memory stick".

+

The glossAlternateFor element is available inside the glossAlt element, which is a container that provides a variant for the primary glossentry term. In some cases, the variant might also be an alternate for another term. In the example below, the term "stick" is a variant of the primary term (USB flash drive). The glossAlternateFor element indicates that "stick" is also a variant of the synonym "memory stick".

There is a dependency here between the usage description and an example that is not actaully given in this topic; that seems risky and we should probably move or reuse the example here. diff --git a/specification/langRef/technicalContent/glossScopeNote.dita b/specification/langRef/technicalContent/glossScopeNote.dita index 7ae3eeb4..1bde9c76 100644 --- a/specification/langRef/technicalContent/glossScopeNote.dita +++ b/specification/langRef/technicalContent/glossScopeNote.dita @@ -3,13 +3,9 @@ "reference.dtd"> <xmlelement>glossScopeNote</xmlelement> - The glossScopeNote element contains a clarification of the - subject that is designated by the glossterm, such as examples of - included or excluded companies or products. For instance, a scope note for "Linux" might explain - that the term does not apply to UNIX products; it might give examples of Linux products that are - included as well as UNIX products that are excluded.I think we really need to clarify "the subject that is designated by the - glossterm" + The glossScopeNote element clarifies the subject that is designated by the glossterm, such as examples of included or excluded companies or products. For instance, a scope note for "Linux" might explain that the term does not apply to UNIX products. It might give examples of Linux products that are included as well as UNIX products that are excluded.I think we really need to clarify "the subject that is designated by the glossterm" diff --git a/specification/langRef/technicalContent/glossStatus.dita b/specification/langRef/technicalContent/glossStatus.dita index 4916c208..b157af52 100644 --- a/specification/langRef/technicalContent/glossStatus.dita +++ b/specification/langRef/technicalContent/glossStatus.dita @@ -3,10 +3,7 @@ "reference.dtd"> <xmlelement>glossStatus</xmlelement> - The glossStatus element identifies the usage status of a - preferred or alternate term. If the status is not specified, the - glossterm provides a preferred term and an alternate term provides an - allowed term. + The glossary status element identifies the usage status of a preferred or alternate term. If the status is not specified, the glossterm provides a preferred term, and an alternate term provides an allowed term. diff --git a/specification/langRef/technicalContent/glossSymbol.dita b/specification/langRef/technicalContent/glossSymbol.dita index cd778cbd..3137511f 100644 --- a/specification/langRef/technicalContent/glossSymbol.dita +++ b/specification/langRef/technicalContent/glossSymbol.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossSymbol</xmlelement> -The glossSymbol element identifies a standard image that is - associated with the subject of the glossterm element. +The glossary symbol element identifies a standard image that is associated with the subject of the glossterm element. glossariesimages diff --git a/specification/langRef/technicalContent/glossSynonym.dita b/specification/langRef/technicalContent/glossSynonym.dita index 410a5c50..152128b6 100644 --- a/specification/langRef/technicalContent/glossSynonym.dita +++ b/specification/langRef/technicalContent/glossSynonym.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossSynonym</xmlelement> -The glossSynonym element provides a term that is a synonym of -the primary value in the glossterm element. +The glossary synonym element provides a term that is a synonym of the primary value in the glossterm element. glossariessynonyms diff --git a/specification/langRef/technicalContent/glossUsage.dita b/specification/langRef/technicalContent/glossUsage.dita index 7781e467..28cf332d 100644 --- a/specification/langRef/technicalContent/glossUsage.dita +++ b/specification/langRef/technicalContent/glossUsage.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossUsage</xmlelement> - The glossUsage element provides information about the correct - use of a term, such as where or how it can be used. + The glossary usage element provides information about the correct use of a term, such as where or how it can be used. From 79bfdb757784552b23a2ad5db056d471faa8f1de Mon Sep 17 00:00:00 2001 From: bburns-hp Date: Wed, 18 Jan 2023 16:37:47 -0700 Subject: [PATCH 3/4] Editing of short descriptions in light of new guidelines --- specification/langRef/technicalContent/glossAbbreviation.dita | 2 +- specification/langRef/technicalContent/glossAcronym.dita | 2 +- specification/langRef/technicalContent/glossAlt.dita | 2 +- specification/langRef/technicalContent/glossAlternateFor.dita | 2 +- specification/langRef/technicalContent/glossBody.dita | 2 +- specification/langRef/technicalContent/glossProperty.dita | 2 +- specification/langRef/technicalContent/glossScopeNote.dita | 2 +- specification/langRef/technicalContent/glossShortForm.dita | 3 +-- specification/langRef/technicalContent/glossdef.dita | 2 +- specification/langRef/technicalContent/glossentry.dita | 4 ++-- specification/langRef/technicalContent/glossterm.dita | 2 +- 11 files changed, 12 insertions(+), 13 deletions(-) diff --git a/specification/langRef/technicalContent/glossAbbreviation.dita b/specification/langRef/technicalContent/glossAbbreviation.dita index 639d952f..e1fdd879 100644 --- a/specification/langRef/technicalContent/glossAbbreviation.dita +++ b/specification/langRef/technicalContent/glossAbbreviation.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossAbbreviation</xmlelement> - The glossary abbreviation element provides an abbreviated form of the term that is contained in a glossary term element. + The glossary abbreviation provides an abbreviated form of the term that is contained in a glossary term. diff --git a/specification/langRef/technicalContent/glossAcronym.dita b/specification/langRef/technicalContent/glossAcronym.dita index b4989142..f80ecce8 100644 --- a/specification/langRef/technicalContent/glossAcronym.dita +++ b/specification/langRef/technicalContent/glossAcronym.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossAcronym</xmlelement> - The glossary acronym element defines an acronym for the term that is defined in the glossary term element. + The glossary acronym defines an acronym for a glossary term . diff --git a/specification/langRef/technicalContent/glossAlt.dita b/specification/langRef/technicalContent/glossAlt.dita index 36dc1823..e5dd06e7 100644 --- a/specification/langRef/technicalContent/glossAlt.dita +++ b/specification/langRef/technicalContent/glossAlt.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossAlt</xmlelement> - The glossary alternative element contains a variant term for the preferred term that is defined in the glossary term element. + The glossary alternative contains a variant term for the preferred term that is defined in a glossary term. diff --git a/specification/langRef/technicalContent/glossAlternateFor.dita b/specification/langRef/technicalContent/glossAlternateFor.dita index 28e42c59..574ff785 100644 --- a/specification/langRef/technicalContent/glossAlternateFor.dita +++ b/specification/langRef/technicalContent/glossAlternateFor.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossAlternateFor</xmlelement> -The glossAlternateFor element indicates when a variant term has a relationship to another variant term in addition to the preferred term.The glossAlternateFor element indicates when a variant term has a relationship to another variant term as well as the preferred term.Does it "indicate when a variant term has a relationship" or does it specify that there is a relationship with a specific other term? diff --git a/specification/langRef/technicalContent/glossBody.dita b/specification/langRef/technicalContent/glossBody.dita index 6869bf48..b7f545d2 100644 --- a/specification/langRef/technicalContent/glossBody.dita +++ b/specification/langRef/technicalContent/glossBody.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossBody</xmlelement> -The glossary body element is used to provide details about a glossary term, such as part of speech or additional forms of the term. +The glossary body provides details about a glossary term, such as part of speech or additional forms of the term. glossBody glossentry diff --git a/specification/langRef/technicalContent/glossProperty.dita b/specification/langRef/technicalContent/glossProperty.dita index de42b01d..e071666a 100644 --- a/specification/langRef/technicalContent/glossProperty.dita +++ b/specification/langRef/technicalContent/glossProperty.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossProperty</xmlelement> -The glossary property element specifies additional details about the preferred term or its subject, such as the gender of a noun. +The glossary property provides additional details about the preferred term or its subject, such as the gender of a noun. glossariesextension points diff --git a/specification/langRef/technicalContent/glossScopeNote.dita b/specification/langRef/technicalContent/glossScopeNote.dita index 1bde9c76..b9fdb6a8 100644 --- a/specification/langRef/technicalContent/glossScopeNote.dita +++ b/specification/langRef/technicalContent/glossScopeNote.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossScopeNote</xmlelement> - The glossScopeNote element clarifies the subject that is designated by the glossterm, such as examples of included or excluded companies or products. For instance, a scope note for "Linux" might explain that the term does not apply to UNIX products. It might give examples of Linux products that are included as well as UNIX products that are excluded.The glossScopeNote element clarifies the sense of the glossterm, such as inclusions, exclusions, or restrictions of that sense. For instance, a scope note for "Linux" might explain that the term does not apply to UNIX products. It might give examples of Linux products that are included as well as UNIX products that are excluded.I think we really need to clarify "the subject that is designated by the glossterm" diff --git a/specification/langRef/technicalContent/glossShortForm.dita b/specification/langRef/technicalContent/glossShortForm.dita index d4ca5b76..d375083f 100644 --- a/specification/langRef/technicalContent/glossShortForm.dita +++ b/specification/langRef/technicalContent/glossShortForm.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossShortForm</xmlelement> -The glossShortForm element provides a shorter alternative to the - primary term that is specified in the glossterm element. +The glossary short form provides a shorter alternative to the primary glossary term. glossariesshort forms of a term diff --git a/specification/langRef/technicalContent/glossdef.dita b/specification/langRef/technicalContent/glossdef.dita index 29c33b08..150cfc76 100644 --- a/specification/langRef/technicalContent/glossdef.dita +++ b/specification/langRef/technicalContent/glossdef.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossdef</xmlelement> -The gloss definition element specifies the definition of one sense of a term. +The gloss definition describes one sense of a term. glossariesdefinitions diff --git a/specification/langRef/technicalContent/glossentry.dita b/specification/langRef/technicalContent/glossentry.dita index a8c0870f..730a97aa 100644 --- a/specification/langRef/technicalContent/glossentry.dita +++ b/specification/langRef/technicalContent/glossentry.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossentry</xmlelement> - The glossary entry element defines a single sense of a glossary term. Glossary entries for different term senses can be reused independently of one another. + The glossary entry contains information for a single sense of a glossary term. Glossary entries for different term senses can be reused independently of one another. @@ -17,7 +17,7 @@
Processing expectations -

The recommended book processing is to sort and group glossary entries based on the localized term so a back-of-the-book glossary can contain a collated list of terms with the definitions of the individual senses of each term indented under the term. The glossary can have a different organization in different languages depending on the translation of the terms.

+

The recommended book processing is to sort and group glossary entries based on the localized term. This processing makes it possible that a back-of-the-book glossary can contain a collated list of terms along with definitions of each sense of each term indented under the term. The glossary can have a different organization in different languages depending on the translation of the terms.

One possible implementation of a glossary in online processing is to associate a hotspot for mentions of terms in term elements and display the definition on hover or click.

diff --git a/specification/langRef/technicalContent/glossterm.dita b/specification/langRef/technicalContent/glossterm.dita index 76150544..51d4f444 100644 --- a/specification/langRef/technicalContent/glossterm.dita +++ b/specification/langRef/technicalContent/glossterm.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossterm</xmlelement> -The glossary term element specifies the preferred term that is associated with a definition of a sense. If the same term has multiple senses, create a separate glossary entry topic for each sense.The glossary term indicates the preferred term that is associated with a definition of a sense. If the same term has multiple senses, each should be a separate glossary entry.associated with a definition of a "sense"? I think we need to clear that up. From d3b26eac893b19507aecae8b394620d3300f01e5 Mon Sep 17 00:00:00 2001 From: bburns-hp Date: Thu, 19 Jan 2023 14:58:59 -0700 Subject: [PATCH 4/4] Addition editing of short descrip\tions --- .../langRef/technicalContent/abbreviated-form.dita | 3 +-- specification/langRef/technicalContent/glossStatus.dita | 2 +- .../langRef/technicalContent/glossSurfaceForm.dita | 4 +--- specification/langRef/technicalContent/glossSymbol.dita | 2 +- specification/langRef/technicalContent/glossSynonym.dita | 2 +- specification/langRef/technicalContent/glossUsage.dita | 2 +- specification/langRef/technicalContent/glossgroup.dita | 3 +-- specification/langRef/technicalContent/glossref.dita | 7 +------ 8 files changed, 8 insertions(+), 17 deletions(-) diff --git a/specification/langRef/technicalContent/abbreviated-form.dita b/specification/langRef/technicalContent/abbreviated-form.dita index 1005858a..22ef072f 100644 --- a/specification/langRef/technicalContent/abbreviated-form.dita +++ b/specification/langRef/technicalContent/abbreviated-form.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>abbreviated-form</xmlelement> -The abbreviated-form element represents a reference to a term - that might appear in an abbreviated form (often an acronym). +Abbreviated form represents a shorter reference to a term (often an acronym). diff --git a/specification/langRef/technicalContent/glossStatus.dita b/specification/langRef/technicalContent/glossStatus.dita index b157af52..43c2e2d7 100644 --- a/specification/langRef/technicalContent/glossStatus.dita +++ b/specification/langRef/technicalContent/glossStatus.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossStatus</xmlelement> - The glossary status element identifies the usage status of a preferred or alternate term. If the status is not specified, the glossterm provides a preferred term, and an alternate term provides an allowed term. + The glossary status identifies the usage status of a preferred or alternate term. If the status is not specified, the glossterm provides a preferred term, and glossAltprovides an allowed term. diff --git a/specification/langRef/technicalContent/glossSurfaceForm.dita b/specification/langRef/technicalContent/glossSurfaceForm.dita index d42779f8..348bf95b 100644 --- a/specification/langRef/technicalContent/glossSurfaceForm.dita +++ b/specification/langRef/technicalContent/glossSurfaceForm.dita @@ -3,9 +3,7 @@ "reference.dtd"> <xmlelement>glossSurfaceForm</xmlelement> - The glossSurfaceForm element specifies an unambiguous - presentation of the glossterm that might combine multiple forms. The - surface form is suitable to introduce the term in new contexts. + The glossary surface form provides an unambiguous presentation of the glossterm that might combine multiple forms. The surface form is suitable to introduce the term in new contexts. diff --git a/specification/langRef/technicalContent/glossSymbol.dita b/specification/langRef/technicalContent/glossSymbol.dita index 3137511f..837b8dac 100644 --- a/specification/langRef/technicalContent/glossSymbol.dita +++ b/specification/langRef/technicalContent/glossSymbol.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossSymbol</xmlelement> -The glossary symbol element identifies a standard image that is associated with the subject of the glossterm element. +The glossary symbol identifies a standard image that is associated with the subject of the glossterm element. glossariesimages diff --git a/specification/langRef/technicalContent/glossSynonym.dita b/specification/langRef/technicalContent/glossSynonym.dita index 152128b6..8b9d0269 100644 --- a/specification/langRef/technicalContent/glossSynonym.dita +++ b/specification/langRef/technicalContent/glossSynonym.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossSynonym</xmlelement> -The glossary synonym element provides a term that is a synonym of the primary value in the glossterm element. +The glossary synonym provides a term that is equivalent in meaning to the primary value in the glossterm element. glossariessynonyms diff --git a/specification/langRef/technicalContent/glossUsage.dita b/specification/langRef/technicalContent/glossUsage.dita index 28cf332d..22fd27e3 100644 --- a/specification/langRef/technicalContent/glossUsage.dita +++ b/specification/langRef/technicalContent/glossUsage.dita @@ -3,7 +3,7 @@ "reference.dtd"> <xmlelement>glossUsage</xmlelement> - The glossary usage element provides information about the correct use of a term, such as where or how it can be used. + Glossary usage provides information about the correct use of a term, such as where or how it can be used. diff --git a/specification/langRef/technicalContent/glossgroup.dita b/specification/langRef/technicalContent/glossgroup.dita index b0e47724..3f2839bf 100644 --- a/specification/langRef/technicalContent/glossgroup.dita +++ b/specification/langRef/technicalContent/glossgroup.dita @@ -3,8 +3,7 @@ "reference.dtd"> <xmlelement>glossgroup</xmlelement> - The glossgroup is a specialized topic that can contain - multiple glossentry topics within a single document. + Glossary group is a specialized topic that can contain multiple glossentry topics within a single document. diff --git a/specification/langRef/technicalContent/glossref.dita b/specification/langRef/technicalContent/glossref.dita index 6c648f5d..9c502371 100644 --- a/specification/langRef/technicalContent/glossref.dita +++ b/specification/langRef/technicalContent/glossref.dita @@ -3,12 +3,7 @@ "reference.dtd"> <xmlelement>glossref</xmlelement> -The glossref element is a convenience element in maps for -creating a reference to a glossary topic. It has a required keys attribute, which -forces the author to create a key by which inline terms can reference their definition. For example, -when glossentry topics are used to define acronyms, this reminds authors to -create a key which abbreviated-form elements can use to reference the short -and expanded versions of that acronym. +Glossarry reference is a convenience element in maps for creating a reference to a glossary topic. It has a required keys attribute, which forces the author to create a key by which inline terms can reference their definition. For example, when glossentry topics are used to define acronyms, this reminds authors to create a key which abbreviated-form elements can use to reference the short and expanded versions of that acronym. glossref glossary-related