Skip to content

[Feat] Automatically link glossary entries - #106

Merged
ByteOtter merged 10 commits into
mainfrom
feat/auto-glossar
Jul 23, 2026
Merged

[Feat] Automatically link glossary entries#106
ByteOtter merged 10 commits into
mainfrom
feat/auto-glossar

Conversation

@ByteOtter

@ByteOtter ByteOtter commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

What this PR does / why we need it:

This PR adds a new feature to allow users to quickly link a given abbreviation or name to a glossary entry.

This will look like this in any given text:

This is a sample text about gardenlinux {{glossary:flavors}}.

This shorthand will then be replaced into a clickable link automatically during aggregation or by running make glossary.

This is a sample test about gardenlinux [flavors](/reference/glossary.html#flavor)

In addition, this PR fixes a bunch of formatting and linting issues throughout the codebase, strengthens our linters by minor configuration changes and introduces a new testsuite for this feature.

Preliminary usage documentation can be found in the deploy preview: https://deploy-preview-106--gardenlinux-docs.netlify.app/contributing/documentation/auto-glossary.html

Which issue(s) this PR fixes:
Fixes: gardenlinux/gardenlinux#4637

Definition of Done:

  • The code is sufficiently documented
  • Shared the changes with the Team so everyone is aware
  • The code is appropriately tested
  • Checked if the code needs to be backportet to release branches of maintained versions (perform the actual backport after the merge to main)

Special notes for your reviewer:

Release note:

@netlify

netlify Bot commented Jul 8, 2026

Copy link
Copy Markdown

Deploy Preview for gardenlinux-docs ready!

Name Link
🔨 Latest commit 6290377
🔍 Latest deploy log https://app.netlify.com/projects/gardenlinux-docs/deploys/6a61d9f4ac99cc0008465f0c
😎 Deploy Preview https://deploy-preview-106--gardenlinux-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@ByteOtter
ByteOtter force-pushed the feat/auto-glossar branch 5 times, most recently from 1b9afe9 to 9298e07 Compare July 9, 2026 15:18
@ByteOtter
ByteOtter marked this pull request as ready for review July 9, 2026 15:20
@ByteOtter
ByteOtter force-pushed the feat/auto-glossar branch 3 times, most recently from 3fbd693 to 783fc3e Compare July 13, 2026 12:37
@ByteOtter ByteOtter self-assigned this Jul 13, 2026
@ByteOtter
ByteOtter requested a review from yeoldegrove July 13, 2026 12:40
@ByteOtter ByteOtter added documentation Improvements or additions to documentation enhancement New feature or request dependencies Pull requests that update a dependency file labels Jul 13, 2026
@yeoldegrove yeoldegrove added this to the 2026-07 milestone Jul 14, 2026

@yeoldegrove yeoldegrove left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general, I would like this search/replace to not run on the make aggregate(-|) steps but only on the make build steps to not leave unstaged files in git.

Comment thread docs/contributing/documentation/auto-glossary.md
Comment thread docs/contributing/documentation/auto-glossary.md
Comment thread docs/contributing/documentation/auto-glossary.md
@ByteOtter
ByteOtter force-pushed the feat/auto-glossar branch from a936581 to e7b6dc6 Compare July 15, 2026 10:27
@ByteOtter

Copy link
Copy Markdown
Collaborator Author

I also changed the behaviour of this feature to run right before the build script in the make build step.

@ByteOtter
ByteOtter force-pushed the feat/auto-glossar branch 5 times, most recently from 772de3e to f3593b4 Compare July 22, 2026 13:26
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
On-behalf-of: SAP <tiara.hock@sap.com>
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
On-behalf-of: SAP <tiara.hock@sap.com>
* Fix files not processing if name matching with "glossary"
* Move auto glossary step from aggregation to build

Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
On-behalf-of: SAP <tiara.hock@sap.com>
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
Tests: Remove auto-link tests

Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
* Reorder targets
* Add new transform target
* Remove glossary from build target
* Add new publish target

Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
@ByteOtter
ByteOtter force-pushed the feat/auto-glossar branch from 0768581 to 6290377 Compare July 23, 2026 09:04
@ByteOtter
ByteOtter merged commit c726955 into main Jul 23, 2026
10 of 11 checks passed
@ByteOtter
ByteOtter deleted the feat/auto-glossar branch July 23, 2026 09:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[ER] [Docs Hub] Automate Abbreviation references

2 participants