From e053a623e6d0162d9a60ffd85186abbe6d121c4b Mon Sep 17 00:00:00 2001 From: Jon Surrell Date: Wed, 31 Jan 2024 16:46:30 +0100 Subject: [PATCH] Add description to test class --- tests/phpunit/tests/html-api/wpHtmlProcessorHtml5lib.php | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/tests/phpunit/tests/html-api/wpHtmlProcessorHtml5lib.php b/tests/phpunit/tests/html-api/wpHtmlProcessorHtml5lib.php index 128d33733208a..51c8292b1a6d6 100644 --- a/tests/phpunit/tests/html-api/wpHtmlProcessorHtml5lib.php +++ b/tests/phpunit/tests/html-api/wpHtmlProcessorHtml5lib.php @@ -3,7 +3,14 @@ /** * Unit tests covering HTML API functionality. * - * @todo add descriptive paragraph here. + * This test suite runs a set of tests on the HTML API using a third-party suite of test fixtures. + * A third-party test suite allows the HTML API's behavior to be compared against an external + * standard. Without a third-party, there is risk of oversight or misinterpretation of the standard + * being implemented in application code and in tests. html5lib-tests is used by other projects like + * browsers or other HTML parsers for the same purpose of validating behavior against an + * external reference. + * + * See the README file at DIR_TESTDATA / html5lib-tests for details on the third-party suite. * * @package WordPress * @subpackage HTML-API