Added more sectional structure to README.md

Author: roxspring

README.md

@@ -37,21 +37,17 @@ dependencies {
 }
 ```
 
-## Annotations
-
 Annotations placed on packages affect tests for all classes and methods under test in that package.
 Annotations placed on classes affect tests for that class and all it's methods under test, overriding package level annotations.
 Annotations placed on methods affect just that method under test, overriding package and class level annotations.
 
-| Annotation                 | Equivalent `dcover create` option |
-|:---------------------------|:----------------------------------|
-| `@InTestsMock`             | `--mock`, `--disable-mock-inputs` |
-| `@InTestsMockConstruction` | `--mock-construction`             |
-| `@InTestsMockStatic`       | `--mock-static`                   |
-
 The annotations will be respected by Diffblue Cover via both command line and IntelliJ Plugin.
 When used from the command line in conjunction with equivalent options then the command line options take priority over the annotations found.
 
+## Mocking Annotations
+
+Mocking annotations allow fine grained control over what mocking should be preferred when testing.
+
 ### Using `@InTestsMock`
 
 Perhaps you have a method that Diffblue Cover would ordinarily test using an `Integer` but you'd prefer to see it tested using `Mockito.mock(..)`.
@@ -77,6 +73,13 @@ public class ClassUnderTest {
 }
 ```
 
+> [!NOTE]
+> Using `@InTestsMock` has the same effect as, and can be overridden by, Cover CLI command line options:
+>
+> ```
+> dcover create --mock ClassToMock --disable-mock-inputs ClassToForbidMocking
+> ```
+
 ### Using `@InTestsMockConstruction`
 
 Perhaps you have a method that Diffblue Cover is unable to test, and you think it could make more progress using `Mockito.mockConstruction(Random.class)`.
@@ -91,6 +94,13 @@ public class ClassUnderTest {
 }
 ```
 
+> [!NOTE]
+> Note that using `@InTestsMockConstruction` has the same effect as, and can be overridden by, Cover CLI command line option:
+>
+> ```
+> dcover create --mock-construction ClassToMockConstruction
+> ```
+
 ### Using `@InTestsMockStatic`
 
 Perhaps you have a method that Diffblue Cover is unable to test, and you think it could make more progress using `Mockito.mockStatic(UUID.class)`.
@@ -105,6 +115,17 @@ public class ClassUnderTest {
 }
 ```
 
+> [!NOTE]
+> Using `@InTestsMockStatic` has the same effect as, and can be overridden by, Cover CLI command line option:
+>
+> ```
+> dcover create --mock-static ClassToMockStatic
+> ```
+
+## Custom Input Annotations
+
+Custom input annotations allow particular inputs to be recommended to Diffblue Cover when writing tests.
+
 ### Using `@InTestsUseEnum`
 
 The `@InTestsUseEnum` annotation allows the user to recommend specific `enum` literal values to use in tests.
@@ -233,6 +254,10 @@ public static boolean isNearPi(@InTestsUseDoubles(Math.PI) float input) {
 }
 ```
 
+## Interesting Value Annotations
+
+Interesting value annotations allow users to promote existing fields and methods to be identified and used in particular roles by Diffblue Cover when writing tests.
+
 ### Using `@InterestingTestFactory`
 
 Indicates the annotated method as a useful factory method for use in tests.