related links maintenance

nili1 · Aug 1, 2024 · 6f2cac9 · 6f2cac9
1 parent fcd1f5f
commit 6f2cac9
Show file tree

Hide file tree

Showing 13 changed files with 46 additions and 54 deletions.
diff --git a/en-us/course02-authoring_concepts/topics/lc_best_practices_intro.dita b/en-us/course02-authoring_concepts/topics/lc_best_practices_intro.dita
@@ -42,22 +42,16 @@
             format="html" scope="external">
             <linktext>DITA Style Guide, Language and punctuation</linktext>
         </link>
-       <!-- <link href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html"
+        <link
+            href="https://www.scriptorium.com/?s=perils+of+dita"
             format="html" scope="external">
-            <linktext>The DITA Style Guide—Best Practices for Authors (Tony Self)</linktext>
+            <linktext>Perils of DITA publishing series (Scriptorium.com)</linktext>
         </link>
-        <link href="https://www.scriptorium.com/structure.pdf" format="html" scope="external">
-            <linktext>Structured Authoring and XML (Sarah O’Keefe)</linktext>
+        <link href="https://www.w3schools.com/xml/xml_whatis.asp" format="html" scope="external">
+            <linktext>W3C Schools, Introduction to XML</linktext>
         </link>
-        <link
-            href="https://www.scriptorium.com/2014/03/making-the-most-of-your-conversion-to-xml-part-1/"
-            format="html" scope="external">
-            <linktext>Making the most of your conversion to XML (Scriptorium.com)</linktext>
+        <link href="https://www.scriptorium.com/2017/04/structured-authoring-and-xml/" format="html" scope="external">
+            <linktext>Structured Authoring and XML (Sarah O’Keefe)</linktext>
         </link>
-        <link
-            href="https://www.scriptorium.com/2012/09/perils-of-dita-publishing-part-4-pdf-acrobatics/"
-            format="html" scope="external">
-            <linktext>Perils of DITA publishing (Scriptorium.com)</linktext>
-        </link>-->
     </related-links>
 </learningContent>
diff --git a/en-us/course04-authoring_gloss_reference/topics/lc_creating_ref.dita b/en-us/course04-authoring_gloss_reference/topics/lc_creating_ref.dita
@@ -36,7 +36,7 @@
     </learningContentbody>
     <related-links>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Topics_and_Information_Types/c_Reference.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Topics_and_Information_Types/c_Reference.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, Reference</linktext>
         </link>

diff --git a/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_advanced_ditamaps.dita b/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_advanced_ditamaps.dita
@@ -33,7 +33,7 @@
     </learningContentbody>
     <related-links>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/c_Types_of_Metadata.html"
+            href="https://www.oxygenxml.com/dita/styleguide/c_Types_of_Metadata.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, Metadata</linktext>
         </link>

diff --git a/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_a_bookmap.dita b/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_a_bookmap.dita
@@ -34,20 +34,19 @@
     </learningContentbody>
     <related-links>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Maps/c_bookmap_application.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Maps/c_bookmap_application.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, The bookmap feature</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Maps/c_Nesting_bookmaps_Within_ditmaps.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Maps/c_Nesting_bookmaps_Within_ditmaps.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, Nesting bookmaps within ditamaps</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Maps/c_bookmap_example.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Maps/c_bookmap_example.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, Sample bookmap file</linktext>
         </link>
-
     </related-links>
 </learningContent>
diff --git a/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_a_map.dita b/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_creating_a_map.dita
@@ -33,17 +33,17 @@
     </learningContentbody>
     <related-links>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Maps/c_Working_with_Map_Files.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Maps/c_Working_with_Map_Files.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, Purpose of ditamap files</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Maps/c_DITA_Map_Vocabulary.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Maps/c_DITA_Map_Vocabulary.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, DITA map vocabulary</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Maps/c_The_topicref_Element.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Maps/c_The_topicref_Element.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, The topicref element</linktext>
         </link>

diff --git a/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_reltables.dita b/en-us/course05-using_dita_maps_and_bookmaps/topics/lc_reltables.dita
@@ -32,17 +32,18 @@
         </lcIntro>
     </learningContentbody>
     <related-links>
-        <link href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html#Artefact/Maps/c_Understanding_Relationship_Tables.html"
+        <link href="https://www.oxygenxml.com/dita/styleguide/Maps/c_Understanding_Relationship_Tables.html"
             format="html" scope="external">
             <linktext>DITA Style Guide, Relationship tables</linktext>
         </link>
         <link href="https://jaymanalotoibm.wordpress.com/2013/11/08/dissecting-dita-relationship-tables"
             format="html" scope="external">
             <linktext>Dissecting DITA relationship tables</linktext>
         </link>
-        <link href="https://dita.xml.org/improving-relationships-relationship-tables"
+        <!-- [AAB 2024-08-01] TO DO: Replace link with equivalent link to DITA spec. -->
+        <!--<link href="https://dita.xml.org/improving-relationships-relationship-tables"
             format="html" scope="external">
             <linktext>Improving Relationships in Relationship Tables</linktext>
-        </link>
+        </link>-->
     </related-links>
 </learningContent>
diff --git a/en-us/course06-reuse_basic/maps/lc_creating_reusable_topics.dita b/en-us/course06-reuse_basic/maps/lc_creating_reusable_topics.dita
@@ -33,17 +33,17 @@
     </learningContentbody>
     <related-links>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Language_and_Punctuation/c_Glue_Text.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Language_and_Punctuation/c_Glue_Text.html"
             format="html">
             <linktext>DITA Style Guide, Stem sentences, glue text, and other transitional information</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Writing_For_Reuse.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Writing_For_Reuse.html"
             format="html">
             <linktext>DITA Style Guide, Writing for re-use</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Re-use_Guidelines.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Re-use_Guidelines.html"
             format="html">
             <linktext>DITA Style Guide, Re-use guidelines</linktext>
         </link>

diff --git a/en-us/course06-reuse_basic/topics/lc_intro_to_reuse.dita b/en-us/course06-reuse_basic/topics/lc_intro_to_reuse.dita
@@ -34,12 +34,12 @@
     </learningContentbody>
     <related-links>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Content_Reuse_Definition.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Content_Reuse_Definition.html"
             format="html">
             <linktext>DITA Style Guide, Content re-use definition</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Reuse_Maturity_Model.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Reuse_Maturity_Model.html"
             format="html">
             <linktext>DITA Style Guide, Re-use and the DITA Maturity Model</linktext>
         </link>

diff --git a/en-us/course06-reuse_basic/topics/lc_maps_and_topics.dita b/en-us/course06-reuse_basic/topics/lc_maps_and_topics.dita
@@ -33,18 +33,19 @@
     </learningContentbody>
     <related-links>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Embedded_Topics.html"
-            format="html">
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Embedded_Topics.html"
+            format="html" scope="external">
             <linktext>DITA Style Guide, Embedded topics and ditamaps</linktext>
         </link>
-        <link href="https://blog.oxygenxml.com/2015/11/dita-reuse-strategies-short-tutorial.html"
-            format="html">
+        <!-- [AAB 2024-08-01] TO DO: Find equivalent resources to dead links below. -->
+        <!--<link href="https://blog.oxygenxml.com/2015/11/dita-reuse-strategies-short-tutorial.html"
+            format="html" scope="external">
             <linktext>DITA Reuse Strategies</linktext>
-        </link>
-        <link
+        </link>-->
+        <!--<link
             href="https://dita.xml.org/reuse-strategies"
             format="html">
             <linktext>Reuse strategies and the mechanisms that support them</linktext>
-        </link>
+        </link>-->
     </related-links>
 </learningContent>
diff --git a/en-us/course06-reuse_basic/topics/lc_using_conrefs.dita b/en-us/course06-reuse_basic/topics/lc_using_conrefs.dita
@@ -26,18 +26,19 @@
     <related-links>
         <link
             href="https://docs.oasis-open.org/dita/v1.2/os/spec/common/theconrefattribute.html#theconrefattribute"
-            format="html" scope="external">
+            scope="external" format="html">
             <linktext>OASIS DITA Version 1.2 Standard, The conref attribute</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Content_Reference.html"
-            format="html" scope="external">
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Content_Reference.html"
+            scope="external" format="html">
             <linktext>DITA Style Guide, The content reference (conref) attribute</linktext>
         </link>
-        <link
+        <!-- [AAB 2024-08-01] Dead link.
+            <link
             href="https://ditachicks.com/2010/12/05/using-content-references-in-dita/"
             format="html" scope="external">
             <linktext>Using content references in DITA</linktext>
-        </link>
+        </link>-->
     </related-links>
 </learningContent>
diff --git a/en-us/course07-reuse_advanced/topics/lc_advanced_conrefs.dita b/en-us/course07-reuse_advanced/topics/lc_advanced_conrefs.dita
@@ -38,12 +38,12 @@
     <related-links>
         <link
             href="https://docs.oasis-open.org/dita/v1.2/os/spec/common/complexattributedefinitions.html"
-            format="html">
+            scope="external" format="html">
             <linktext>DITA Specification, Complex attribute definitions</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Advanced_conref_Principles.html"
-            format="html">
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Advanced_conref_Principles.html"
+            scope="external" format="html">
             <linktext>DITA Style Guide, Advanced conref principles</linktext>
         </link>
         <link href="https://www.scriptorium.com/2015/10/unsung-heroes-of-dita-premium/"
@@ -54,9 +54,5 @@
             scope="external" format="html">
             <linktext>A simple use case for DITA conkeyrefs</linktext>
         </link>
-
-
-
-
     </related-links>
 </learningContent>
diff --git a/en-us/course07-reuse_advanced/topics/lc_using_conditions.dita b/en-us/course07-reuse_advanced/topics/lc_using_conditions.dita
@@ -38,12 +38,12 @@
         </link>
 
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Metadata_Conditional/c_Conditional_Processing_Concepts.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Metadata_Conditional/c_Conditional_Processing_Concepts.html"
             scope="external" format="html">
             <linktext>DITA Style Guide, Conditional processing concepts</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Metadata_Conditional/c_Select_Attributes.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Metadata_Conditional/c_Select_Attributes.html"
             scope="external" format="html">
             <linktext>DITA Style Guide, Condition (or select) attributes</linktext>
         </link>
@@ -54,7 +54,7 @@
         </link>
         <link href="https://docs.oasis-open.org/dita/v1.2/os/spec/common/about-ditaval.html#ditaval"
             format="html" scope="external">
-            <linktext>DITA version 1.3 specification, DITAVAL elements</linktext>
+            <linktext>OASIS DITA version 1.2 Standard, DITAVAL elements</linktext>
         </link>
         <link href="https://www.scriptorium.com/2015/02/conditional-content-dita-premium/" format="html" scope="external">
             <linktext>Conditional content in DITA</linktext>

diff --git a/en-us/course07-reuse_advanced/topics/lc_using_keys.dita b/en-us/course07-reuse_advanced/topics/lc_using_keys.dita
@@ -46,12 +46,12 @@
             <linktext>DITA Specification, Key-based addressing</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Cross_Referencing/c_Indirection_with_keyref.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Cross_Referencing/c_Indirection_with_keyref.html"
             format="html">
             <linktext>DITA Style Guide, Indirect linking with keys</linktext>
         </link>
         <link
-            href="https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/#Artefact/Content_Reuse/c_Variables_Using_keydef.html"
+            href="https://www.oxygenxml.com/dita/styleguide/Content_Reuse/c_Variables_Using_keydef.html"
             format="html">
             <linktext>DITA Style Guide, Variables using indirection</linktext>
         </link>