Commit Graph

23 Commits

Author SHA1 Message Date
Patrik Oldsberg 8f9c1d64b8 verify-links: catch broken anchors, directory links, and invisible characters (#33713)
* verify-links: catch broken anchors, directory links, and invisible characters

Enhances the link verification script to catch several categories of
broken links that were previously missed:

- Broken anchors (cross-file and same-file) by extracting heading slugs
  from target documents and verifying anchors resolve
- Directory links missing index.md suffix within docs/
- Invisible/zero-width characters in URLs
- Case-sensitive anchor mismatches

Also strips fenced code blocks before scanning for links to avoid false
positives, and handles duplicate heading slug deduplication (GitHub and
Docusaurus append -1, -2, etc.).

Fixes a few newly-caught broken links in existing docs.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor

* Fix CodeQL incomplete multi-character sanitization alert

Apply HTML tag stripping in a loop so that nested fragments
like <scr<script>ipt> are fully removed.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor

---------

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-04-03 17:48:40 +02:00
Fredrik Adelöw bb7768ba06 docs: fix broken links and anchors across documentation
Fix ~30 broken links and anchors across the documentation site, including
incorrect relative paths, mismatched anchor names, zero-width characters
in URLs, and references to renamed or removed headings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Fredrik Adelöw <freben@spotify.com>
2026-03-31 18:43:40 +02:00
aramissennyeydd 14a8190e16 fix verify workflow too
Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

add back prebuild script

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

fix script location

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

skip techdocs

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

make references/index tracked in git

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

don't try to build with new reference docs

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

fix redirect

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

disable redirect

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
2025-12-20 20:36:07 -07:00
Andre Wanlin 1d15f6b01b Removed references to Lerna as it's not used
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2025-09-09 11:37:03 +02:00
Steve Lamoree 36bd0b6144 add and update glossary terms (#30395)
Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
Co-authored-by: Steve Lamoree <110703238+slamoree-expertsupport@users.noreply.github.com>
2025-08-01 14:34:04 +00:00
Stephen Lamoree 2fe13df984 minor edits
Signed-off-by: Stephen Lamoree <slamoree@expertsupport.com>
2025-06-24 18:29:42 +02:00
Stephen Lamoree d1ae00744e Revise JWT description to reflect Peter's feedback
Signed-off-by: Stephen Lamoree <slamoree@expertsupport.com>
2025-06-24 18:29:42 +02:00
Stephen Lamoree 6ab1656ddc Add terms to glossary
Signed-off-by: Stephen Lamoree <slamoree@expertsupport.com>
2025-06-24 18:29:42 +02:00
Stephen Lamoree c983ce8f2c Add and update terms in glossary
Signed-off-by: Stephen Lamoree <slamoree@expertsupport.com>
2025-06-24 18:29:42 +02:00
Andre Wanlin b5545900a4 Initial removal
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2025-06-06 13:14:54 -05:00
Patrik Oldsberg a1ae9cc72c docs: restructure local-dev and rename to tooling
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2024-05-30 14:28:23 +02:00
Philipp Hugenroth 1d72a99cf2 Adjust to review
Signed-off-by: Philipp Hugenroth <philipph@spotify.com>
2024-03-06 12:28:14 +01:00
Philipp Hugenroth ad9314d3a7 Rename platform to open source framework
Signed-off-by: Philipp Hugenroth <philipph@spotify.com>
2024-02-28 11:10:57 +01:00
Aramis b408b6e28d differentiate software templates and software template
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-31 12:32:24 -05:00
Aramis Sennyey cd548c7c76 Apply suggestions from code review
Co-authored-by: Dave Welsch <116022979+dwelsch-esi@users.noreply.github.com>
Signed-off-by: Aramis Sennyey <34432188+sennyeya@users.noreply.github.com>
2024-01-31 12:31:50 -05:00
Aramis a5f3d839ec fix links issue
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-30 22:43:30 -05:00
Aramis ddfeada980 remove lengthy definitions
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-30 22:43:23 -05:00
Aramis f0192acb70 fix: condition definition
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-30 22:29:46 -05:00
Aramis 4944f29f2c update documentation and add a simple guide.
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-30 22:28:02 -05:00
Aramis e221a0b285 add more header clarifications
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-29 14:51:56 -05:00
Aramis 312257e1a1 add better headers for differentiating similar terms and add more definitions
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-29 14:49:31 -05:00
Aramis Sennyey fd563915eb Apply suggestions from code review
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Signed-off-by: Aramis Sennyey <34432188+sennyeya@users.noreply.github.com>
2024-01-29 14:34:41 -05:00
Aramis 2e440d4723 docs: add a central glossary
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
2024-01-25 23:42:14 -05:00