Skip to content

Update about_py.md - #84

Open
Honaminto wants to merge 1 commit into
mainfrom
Honaminto-patch-2
Open

Honaminto wants to merge 1 commit into
mainfrom
Honaminto-patch-2

Conversation

@Honaminto

@Honaminto Honaminto commented Oct 2, 2026 •

Copy link
Copy Markdown
Collaborator

Review of the French translation of About These Lectures

  1. Relative Popularity section – the English insertion "one of the most -- if not the most --" doesn't translate naturally into French with this construction, since "l'un des langages les plus populaires" and "le langage le plus populaire" need different grammatical structures.

    • Before: Python est l'un des -- si ce n'est le -- langages de programmation les plus populaires.
    • After: Python est l'un des langages de programmation les plus populaires, si ce n'est le plus populaire.
  2. NumPy Alternatives section – the placement of intégrés was ambiguous and could be read as modifying only opérations sur les tableaux rather than both array types and array operations.

    • Before: Des bibliothèques telles que JAX, PyTorch et CuPy disposent également de types de tableaux et d'opérations sur les tableaux intégrés qui peuvent être très rapides et efficaces.
    • After: Des bibliothèques telles que JAX, PyTorch et CuPy intègrent également des types de tableaux et des opérations sur les tableaux qui peuvent être très rapides et efficaces.
  3. Graphics section – terminology consistency with the figure caption immediately below it (Exemple de tracé de contour).

    • Before: des tracés, des histogrammes, des images de contours, des graphiques 3D, des diagrammes à barres, etc.
    • After: des tracés, des histogrammes, des tracés de contours, des graphiques 3D, des diagrammes à barres, etc.
  4. Graphics section – capitalization of Matplotlib for consistency with the rest of the document.

    • Before: une interface de haut niveau pour matplotlib
    • After: une interface de haut niveau pour Matplotlib

@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown

📖 Netlify Preview Ready!

Preview URL: https://pr-84--verdant-toffee-3261a8.netlify.app

Commit: aa1d617

📚 Changed Lectures


Build Info

@Honaminto

Copy link
Copy Markdown
Collaborator Author

Hey Matt, I have a quick question on convention. I've noticed the chapters aren't fully consistent about whether comments and docstrings inside code cells get translated into French. about_py.md already has French comments like # Charger la bibliothèque, but some other chapters leave comments and docstrings in English. Should we translate explanatory comments and docstrings consistently going forward, while leaving code identifiers, API names, and executable output strings as-is? Want to make sure I'm applying the same rule across chapters rather than deciding it one by one.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant