CLDR-19006 last update to link anchors, and document (#5153)

(cherry picked from commit 032243b)

Author: srl295

.github/workflows/gh-pages.yml

@@ -1,4 +1,3 @@
-
 name: gh-pages
 
 # Note: we have a foot in two camps here, maybe more
@@ -27,7 +26,7 @@ on:
     paths:
       - "tools/scripts/tr-archive/**"
       - "docs/**"
-      - '.github/workflows/gh-pages.yml'
+      - ".github/workflows/gh-pages.yml"
 jobs:
   build:
     name: "Build Github Pages"
@@ -47,17 +46,18 @@ jobs:
       - uses: nodenv/actions/node-version@v4 # setup using .node-version
       - name: Run TR archiver
         # Note: will update ToC if out of date
-        run: 'cd tools/scripts/tr-archive/ && npm ci && npm run build'
+        run: "cd tools/scripts/tr-archive/ && npm ci && npm run build"
       - name: Run Kbd Charts
-        run: 'cd docs/charts/keyboards && npm ci && npm run build'
+        run: "cd docs/charts/keyboards && npm ci && npm run build"
       - name: Upload tr35.zip
         uses: actions/upload-artifact@v4
         with:
           name: tr35-spec
           path: tools/scripts/tr-archive/tr35.zip
-      - name: 'Run TR link extractor (experimental)'
+      - name: "Check internal anchors in spec"
         # Note: see CLDR-16526 for making this an error
-        run: 'cd tools/scripts/tr-archive/ && npm run extract-link-targets || (echo Warning, please fix these ; true)'
+        # see <tools/scripts/tr-archive/README.md> for instructions
+        run: "cd tools/scripts/tr-archive/ && npm run extract-link-targets"
       - name: Lint Markdown
         # Warn, don't fail yet
         run: npx markdownlint-cli *.md {specs,docs}/*.md || (echo Warning, please fix these ; true)
@@ -73,10 +73,10 @@ jobs:
       - name: Run lychee
         uses: lycheeverse/lychee-action@v1
         with:
-            args: "-n --cache --max-cache-age 10d docs/rfc docs/ldml"
-            fail: false
-            format: markdown
-            output: linkcheck.md
+          args: "-n --cache --max-cache-age 10d docs/rfc docs/ldml"
+          fail: false
+          format: markdown
+          output: linkcheck.md
       - name: Link Checker Summary
         run: cat linkcheck.md >> $GITHUB_STEP_SUMMARY
       - uses: ruby/setup-ruby@v1
@@ -90,7 +90,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Rearrange stuff
-        run: 'cp -vr tools/scripts/tr-archive/dist/* ./_site/ldml/ && cp tools/scripts/tr-archive/reports-v2.css ./_site/'
+        run: "cp -vr tools/scripts/tr-archive/dist/* ./_site/ldml/ && cp tools/scripts/tr-archive/reports-v2.css ./_site/"
       - name: Deploy to GitHub Pages (main)
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
         uses: actions/upload-pages-artifact@v3

docs/ldml/tr35-collation.md

@@ -290,7 +290,7 @@ Comments with DUCET-style weights in files other than allkeys_CLDR.txt and allke
   An implementation may modify the weights further to fit the needs of its data structures.
 
 * **UCA_Rules** - A file that specifies the root collation order in the form of [tailoring rules](#Collation_Tailorings). This is only an approximation of the FractionalUCA data, since the rule syntax cannot express every detail of the collation elements. For example, in the DUCET and in FractionalUCA, tertiary differences are usually expressed with special tertiary weights on all collation elements of an expansion, while a typical from-rules builder will modify the tertiary weight of only one of the collation elements.
-* **CollationTest_CLDR** - The CLDR versions of the CollationTest files, which use the tailorings for CLDR. For information on the format, see [CollationTest.html](https://www.unicode.org/Public/UCA/latest/CollationTest.html) in the [UCA data directory](https://www.unicode.org/reports/tr10/#Data10).
+* **CollationTest_CLDR** - The CLDR versions of the CollationTest files, which use the tailorings for CLDR. For information on the format, see [UTS #10: 12.2 Conformance Tests](https://unicode.org/reports/tr10/#Conformance_Tests) and the [UCA data directory](https://www.unicode.org/reports/tr10/#Data10).
   * CollationTest_CLDR_NON_IGNORABLE.txt
   * CollationTest_CLDR_SHIFTED.txt
 

docs/ldml/tr35-dates.anchors.json

@@ -7,10 +7,12 @@
   "Calendar_Elements",
   "Calendar_Fields",
   "Calendar_Period_Field_Sets",
+  "Calendar_Preference_Data",
   "calendar-data",
   "calendar-elements",
   "calendar-fields",
   "calendar-period-field-sets",
+  "calendar-preference-data",
   "Composite_Field_Sets",
   "composite-field-sets",
   "Contents",

docs/ldml/tr35-modifications.md

@@ -68,6 +68,7 @@ The LDML specification is divided into the following parts:
 **Changes in LDML Version 48 (Differences from Version 47)**
 <!-- Update the date (need to add/update this comment to pass CI tests that require mods to be updated when spec is) -->
 <!-- Some internal links were updated to fix broken links. -->
+<!-- fixed broken links -->
 
 ### Locale Identifiers and Names
 * [Display Name Elements](tr35-general.md#display-name-elements) Described the usage of the `language` element `menu` values `core` and `extension`, and `alt="menu"`.

tools/scripts/tr-archive/README.md

@@ -37,12 +37,25 @@ $ npm install
 $ npm run fix-tocs
 ```
 
-This will update the tr .md files in place.
+This will update the tr .md files in place. Then, go ahead and check in updates to the .md fioles
+
+## Checking internal link targets and stable anchors
+
+```shell
+$ npm install
+$ npm run build
+$ npm run extract-link-targets
+```
+
+1. fix any errors, such as bad links
+2. there are warnings about duplicate anchors - these are OK.
+3. check the git status an diff on the `docs/ldml/tr35*.anchors.json` files
+  - make sure that any anchors aren't inexplicably removed
+
 ### Copyright
 
 Copyright © 1991-2021 Unicode, Inc.
 All rights reserved.
 [Terms of use](https://www.unicode.org/copyright.html)
 
 See [../../../README.md](../../../README.md) for full project information.
-