Skip to content

Commit 78c2531

Browse files
committed
Very rough sketch of better testing docs
1 parent eb7c485 commit 78c2531

File tree

4 files changed

+377
-571
lines changed

4 files changed

+377
-571
lines changed

best_practices.rst

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -399,8 +399,8 @@ Smoke Test your URLs
399399

400400
In software engineering, `smoke testing`_ consists of *"preliminary testing to
401401
reveal simple failures severe enough to reject a prospective software release"*.
402-
Using :ref:`PHPUnit data providers <testing-data-providers>` you can define a
403-
functional test that checks that all application URLs load successfully::
402+
Using `PHPUnit data providers`_ you can define a functional test that
403+
checks that all application URLs load successfully::
404404

405405
// tests/ApplicationAvailabilityFunctionalTest.php
406406
namespace App\Tests;
@@ -454,3 +454,4 @@ you must set up a redirection.
454454
.. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
455455
.. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
456456
.. _`Webpack`: https://webpack.js.org/
457+
.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers

form/unit_testing.rst

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -121,8 +121,8 @@ variable exists and will be available in your form themes::
121121

122122
.. tip::
123123

124-
Use :ref:`PHPUnit data providers <testing-data-providers>` to test multiple
125-
form conditions using the same test code.
124+
Use `PHPUnit data providers`_ to test multiple form conditions using
125+
the same test code.
126126

127127
.. caution::
128128

@@ -242,3 +242,5 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
242242
:method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeExtensions`
243243
and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
244244
methods.
245+
246+
.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers

0 commit comments

Comments
 (0)