[libcxx-commits] [libcxx] Update testing documentation with testing guidelines. (PR #87928)

Hristo Hristov via libcxx-commits libcxx-commits at lists.llvm.org
Mon Apr 8 21:19:33 PDT 2024


================
@@ -180,6 +180,42 @@ The tests of libc++ are stored in libc++'s testing related subdirectories:
   ``libcxx/test/libcxx``. The structure of this directories follows the
   structure of ``libcxx/test/std``.
 
+Principles of testing
+---------------------
+
+Tests are a practical way to validate the correctness of the code. As such, they contain pragmatic trade offs between
+the cost of writing and maintaining the tests and the value they provide. Please consider the following principles when
+writing tests:
+
+- **Consider the next reader**
+
+    Tests should be obvious to tho future reader. Avoid too much boiler plate or other
----------------
Zingam wrote:

```suggestion
    Tests should be obvious to the future reader. Avoid too much boiler plate or other
```

https://github.com/llvm/llvm-project/pull/87928


More information about the libcxx-commits mailing list