Authoring guidelines/fr: Difference between revisions

Jump to navigation Jump to search
Created page with "Une excellente pratique en programmation est d'ajouter des commentaires explicatifs à même le code. Toutefois, cette information perd de sa valeur si elle n'est pas traduite..."
No edit summary
(Created page with "Une excellente pratique en programmation est d'ajouter des commentaires explicatifs à même le code. Toutefois, cette information perd de sa valeur si elle n'est pas traduite...")
Line 95: Line 95:
so the documentation team has instructed the translator to exclude code blocks from translation.
so the documentation team has instructed the translator to exclude code blocks from translation.


Putting explanatory comments in code is excellent programming practice which we wish to encourage,
Une excellente pratique en programmation est d'ajouter des commentaires explicatifs à même le code. Toutefois, cette information perd de sa valeur si elle n'est pas traduite. Il n'existe pas de solution unique qui fonctionnerait dans tous les cas, mais nous offrons les suggestions suivantes ː
but the value of the comments is decreased if the comments aren't translated.  
# placez les commetaires importants à l'extérieur des blocs de code;
The documentation team has not found a solution for this that works in every case.
# insérez un commentaire en index (par ex. NOTE 1, NOTE 2) pour relier le texte à la ligne de code correspondante;
Here are some suggestions:
# si vous maîtrisez bien l'autre langue et connaissez les fonctions de traduction du wiki, vous pouvez traduire les commentaires.
# Move the information contained in the comments outside the code block, into the surrounding text (which will then be translated).
# Leave an index comment (e.g. "NOTE 1", "NOTE 2") to connect the external text to the relevant line of code.
# If you're sufficiently bilingual, and familiar with the translation apparatus, you may translate the code block yourself.


Please ''do not'' leave example code uncommented, but please ''do'' remember that
Please ''do not'' leave example code uncommented, but please ''do'' remember that
rsnt_translations
54,003

edits

Navigation menu