Bureaucrats, cc_docs_admin, cc_staff
2,879
edits
Authoring guidelines: Difference between revisions
Jump to navigation
Jump to search
Marked this version for translation
(Marked this version for translation) |
|||
| Line 98: | Line 98: | ||
#Click on “Mark this version for translation” | #Click on “Mark this version for translation” | ||
== Code blocks are not translated == | == Code blocks are not translated == <!--T:21--> | ||
Our professional human translator is not a programmer. | Our professional human translator is not a programmer. | ||
They cannot distinguish between code and comments in every possible language, | They cannot distinguish between code and comments in every possible language, | ||
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. | ||
<!--T:22--> | |||
Putting explanatory comments in code is excellent programming practice which we wish to encourage, | Putting explanatory comments in code is excellent programming practice which we wish to encourage, | ||
but the value of the comments is decreased if the comments aren't translated. | but the value of the comments is decreased if the comments aren't translated. | ||
| Line 111: | Line 112: | ||
# If you're sufficiently bilingual, and familiar with the translation apparatus, you may translate the code block yourself. | # If you're sufficiently bilingual, and familiar with the translation apparatus, you may translate the code block yourself. | ||
<!--T:23--> | |||
Please ''do not'' leave example code uncommented, but please ''do'' remember that | Please ''do not'' leave example code uncommented, but please ''do'' remember that | ||
comments will not normally be translated, and consider how this will affect the understanding | comments will not normally be translated, and consider how this will affect the understanding | ||