Skip to content

Doc: content of availability directive lost in i18n #101845

Closed
@jeanas

Description

@jeanas

Bug report

See https://git.afpy.org/AFPy/python-docs-fr/issues/28

For example, take the os.getgid function. https://docs.python.org/3/library/os.html#os.getgid reads

"""
os.getgid()

Return the real group id of the current process.

Availability: Unix.

The function is a stub on Emscripten and WASI, see WebAssembly platforms for more information.
"""

However, the French translation reads

"""
os.getgid()

Renvoie l'identifiant de groupe réel du processus actuel.

Disponibilité : Unix.
"""

This is unexpected. When a paragraph is not translated yet, the original is normally shown. Here, it is dropped.

Not only does this lose content, but it leads to build failures when warnings are turned into errors because the translation can lose some references.

CC @tiran (commit e3b6ff1)

Linked PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dirtype-bugAn unexpected behavior, bug, or error

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions