2025 init

pmd-documentation/UnitTestShouldIncludeAssert.md

@@ -0,0 +1,27 @@
+
+# UnitTestShouldIncludeAssert
+
+*Usage:* 
+`pmd check -d <source code folder> -R category/java/bestpractices.xml/UnitTestShouldIncludeAssert -format <output format>`
+
+*Description:*
+
+JUnit tests should include at least one assertion.  This makes the tests more robust, and using assert
+with messages provide the developer a clearer idea of what the test does.
+        
+
+*Example:*
+```java
+
+
+public class Foo extends TestCase {
+   public void testSomething() {
+      Bar b = findBar();
+   // This is better than having a NullPointerException
+   // assertNotNull("bar not found", b);
+   b.work();
+   }
+}
+
+        
+```