phpunit documentation french

The PHPUnit project is no longer involved with the translation of its documentation to other languages. This repository is now archived.

PHPUnit documentation in French

This repository contains the French documentation for PHPUnit.
The documentation is accessible at https://phpunit.readthedocs.io/en/latest/.

The original documentation in English: https://github.com/sebastianbergmann/phpunit-documentation-english

Translations

Each translation of the documentation is maintained in a dedicated repository:

• Documentation in English
• Documentation in Spanish
• Documentation in French
• Documentation in Brazilian and Portuguese
• Documentation in Japanese
• Simplified Chinese documentation
• Documentation in Russian

Add a new translation

If you would like to create a new translation, please open an issue on the English documentation tracker, indicating the language you wish to translate. A repository will be created and added to the available translations.

Ideally, you will have already prepared a first version based on a fork or a copy of the English documentation which will then be imported into the official repository.

Build the documentation

Prerequisites

• Python
• Sphinx
• Read the Docs Sphinx Theme

Generate HTML documentation

To generate the documentation, run the following command line:

 $ make html

Then you will find the HTML files in build/html .

Automated proofreading

Facility

 $ pip install docutils-ast-writer
$ npm install

Use

 $ ./node_modules/.bin/textlint src

Contribute

Thank you for taking the time to help.

Expected contributions

• Update the documentation following improvements to the English documentation
• If it is an update, specify the commit of the original documentation with which the synchronization is done
• Correct typos, spelling, grammar and syntax errors
• Detecting Franglais and Anglicisms
• Peer review on PR

Instructions for use

• Check the translation guide
• Make a documented Pull requests to master (ideally from a “feature branch”).
• Check that compilation passes before making a pull request
• Leave the code examples in English
• Respect line breaks in the original documentation to facilitate searches and comparisons (line numbers between the English and French documentation must be the same)

Translation guide

The following table lists the translation rules used to guarantee overall consistency. This includes technical terms.

English	French
actual	observed (value)
array	translated by array except when explicitly referring to PHP
assertion	translated as assertion, more telling than affirmation
composable	composable (nothing better found)
expected	expected (value)
framework	framework
isolated	independent (insulated is ambiguous, waterproof a little less...)
instructions	REMARK
return	returns rather than returns
requirements	prerequisites
extension	extensions
code coverage	code coverage
appendix	appendix
fixture	fixture (not found better in French)
stub	cork
verb ing	translated by the infinitive in titles: testing => tester

Recommended reading:

• https://framacalc.org/jargon-francais
• https://www.24joursdeweb.fr/2017/on-dit-numerique-et-pas-digital-bordel/