Issue #5826: Create observability-primer.md (French version)

[iguitton]

Translated the observability-primer.md into French

[iguitton]

Hi @svrnm ,

As mentioned in the PR #5386 (comment), the spell checker is working fine, but it seems that the dictionary lacks many common French words. This is currently blocking the merge.
Adding the 152 missing words to the dictionary for this PR doesn't seem like a sustainable solution. Do you have any suggestions for addressing this issue more effectively?

Thanks,

Isa

[iguitton]

@dmathieu, @codeboten, @marcalff, @theletterf, @cartermp, @austinlparker, @chalin and @svrnm: This PR is ready to be reviewed.

[bertysentry]

Would it be okay if we imported the entire French dictionary into fr-mots.txt to avoid the cumbersome task of adding every single word in the French documentation manually?

[iguitton]

Would it be okay if we imported the entire French dictionary into fr-mots.txt to avoid the cumbersome task of adding every single word in the French documentation manually?

@bertysentry , importing the entire French dictionary could address many issues, but we would still need to add words manually because the spell checker:

• Is case-sensitive: It treats "Collecteur" and "collecteur" as distinct words.
• Does not handle plural or gender variations: Singular and plural forms, as well as masculine and feminine versions, need to be added separately (e.g., "autre" and "autres"; "distribué", "distribuée", "distribués", and "distribuées").
• Does not account for verb conjugations: All conjugated forms of verbs must be explicitly added to pass the spell checker test.
• Does not recognize words with prefixes like "d'" or "l'": These are treated as new words, so both "autre" and "d'autre" need to be added to fr-mots.txt.

While importing a dictionary would reduce the workload, these limitations would still require manual intervention.

[chalin]

Adding the 152 missing words to the dictionary for this PR doesn't seem like a sustainable solution.

I agree that it isn't optimal nor sustainable.

Do you have any suggestions for addressing this issue more effectively?

Submitting PR(s) upstream to https://github.com/streetsidesoftware/cspell-dicts; for example, the last update seems to be streetsidesoftware/cspell-dicts#680. Any volunteers? It would be of benefit to all projects that use cSpell's fr_FR dictionaries.

I'm going to create a separate issue to track this... --> #5870

[chalin]

/fix:format

[opentelemetrybot]

You triggered fix:format action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/12636968824

[opentelemetrybot]

fix:format was successful.

IMPORTANT: (RE-)RUN /fix:all to ensure that there are no remaining check issues.

[chalin]

@iguitton - could you please address the issue highlighted by @bertysentry in #5870 (comment), strip the fr-mots.txt to a minimum, and see if it all works?

[bertysentry]

@iguitton You know where to reach me if needed 😉

[iguitton]

@iguitton - could you please address the issue highlighted by @bertysentry in #5870 (comment), strip the fr-mots.txt to a minimum, and see if it all works?

@chalin : As suggested by @bertysentry , I added fr-fr in the .cspell.yaml file and skimmed the fr-mots.txt file to retain only the observability-specific terminology. Only a few unknown words are now reported by the spelling check which is the expected behavior.

Thank you both for your help.

[bertysentry]

Awesome! 😊

[marcalff]

Great work,

I finally understood what we are working on ;-)

[chalin]

I'm very glad that we got the dictionary issues sorted out. Thanks again @bertysentry for spotting that!