[ro] feature /content/docs/concepts/glossary.md

[didiViking]

Related to #8088

[didiViking]

@chalin Hi, is this last failed error for check links related to false positives? Most of the pages are not yet translated into Romanian, they are linked as per the English version. Please advise, thank you!

[chalin]

@chalin Hi, is this last failed error for check links related to false positives? Most of the pages are not yet translated into Romanian, they are linked as per the English version. Please advise, thank you!

Hi. No, these are real failures. If you inspect the log at https://github.com/open-telemetry/opentelemetry.io/actions/runs/18516852373/job/52769038456?pr=8093, you'll see that it's complaining about missing Header IDs (hashes):

ro/docs/concepts/glossary/index.html
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #metric
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #data-source
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #data-source
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #service
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #metadata
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #signal
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #resource
...

[didiViking]

@chalin Hi, I'm trying to fix the Check Links errors, but the error details point me to some other languages files. I'm blocked in this PR and I'm not sure how to fix this.
@theletterf Any advice from tech writers highly appreciated. Thank you!

[vitorvasc]

Hi, @didiViking!

I can see what is happening here, there are a few things you should do to address the issue with the links, I'll leave some inline comments.

[vitorvasc]

Feel free to reorder the headings alphabetically as well, it helps keep the glossary consistent and easier to navigate. 🙂

[didiViking]

@vitorvasc Thank you for the tips and examples. Now I fixed all missing Header IDs and it's failing due to some Portuguese broken links. Any ideas?

[vitorvasc]

@vitorvasc Thank you for the tips and examples. Now I fixed all missing Header IDs and it's failing due to some Portuguese broken links. Any ideas?

I don't see the Portuguese broken links in the history, could you share which ones you're referring to?

From what I can see in the last run, there are still three remaining errors in content/ro/docs/concepts/glossary.md:

ro/docs/concepts/glossary/index.html
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #distributions
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #receptors
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #signals

[didiViking]

@vitorvasc Thank you for the tips and examples. Now I fixed all missing Header IDs and it's failing due to some Portuguese broken links. Any ideas?

I don't see the Portuguese broken links in the history, could you share which ones you're referring to?

From what I can see in the last run, there are still three remaining errors in content/ro/docs/concepts/glossary.md:

ro/docs/concepts/glossary/index.html
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #distributions
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #receptors
  hash does not exist --- ro/docs/concepts/glossary/index.html --> #signals

I corrected "receptors" but both "distributions" and "signals" are in the plural form in this error but in singular form in the original Header. I tried adding both plural and singular forms and the CI/CD it's still complaining.

[didiViking]

@vitorvasc @theletterf
I'm left with "signals", in this page both "signal" and "signals" exist as hash. If I change it to plural or singular form it complaints the other form doesn't exist. If anyone has an idea how to fix this, please let me know. Thanks!

[didiViking]

@vitorvasc All checks passed, I added all original links at the bottom of the text. Could you please review? I still need to pass this through a Romanian content review. Thank you!

[vitorvasc]

Added a few inline suggestions, that should cover all the link labels now. Let me know if you have any questions 🙂

[chalin]

LGTM. Will let @vitorvasc have a final say, as well as @open-telemetry/docs-ro-approvers.

[vitorvasc]

LGTM!

@IrinaKarantoniou can we have a final approval here?

[IrinaKarantoniou]

@vitorvasc LGTM