Improve Test your declarations page

Author: MattiSG

content/terms/how-to/test-declaration.md

@@ -5,54 +5,45 @@ weight: 4
 
 # Test your declarations
 
-When creating or modifying service declarations, it's important to verify they work as expected. Let's see how to test your declarations in different ways.
+When creating or modifying service declarations, it’s important to verify they work as expected before starting to track in production. The Open Terms Archive engine provides automated testing tools to that end.
 
-## Full testing
-
-To test your declarations by actually fetching the documents and validating the entire process:
+The basic usage to test all declarations in a collection is:
 
 ```sh
 npx ota validate declarations
 ```
 
-It is also possible to test a single service declaration:
-
-```sh
-npx ota validate declarations --services "<service-name>"
-```
+## Testing specific services
 
-Even a single terms of a service can be tested:
+When iterating over a specific declaration, or to narrow down testing in larger collections, the `--services` and `--terms` options enable testing a single service declaration, or even single terms:
 
 ```sh
+npx ota validate declarations --services "<service-name>"
 npx ota validate declarations --services "<service-name>" --terms "<terms-type>"
 ```
 
 ## Schema validation only
 
-For quicker validation that only checks the declaration structure without fetching any documents:
+During initial development, it is useful to check that the JSON structure is correct before even testing the actual document fetching. The `--schema-only` option enables faster validation by only checking the declaration structure without fetching any documents:
 
 ```sh
 npx ota validate declarations --schema-only
 ```
 
-This is useful during initial development to ensure your JSON structure is correct before testing the actual document fetching.
+The same options for targeting specific services and terms are available.
 
-Same options as for the full test are available.
+## Formatting
 
-## Linting declarations
-
-To ensure consistency across all declarations, you should also run the linter:
+To ensure formatting consistency across all declarations, a linter is provided:
 
 ```sh
 npx ota lint
 ```
 
-Same options as for the full test are available.
-
-To automatically fix linting errors:
+To automatically apply the default Open Terms Archive formatting options:
 
 ```sh
 npx ota lint --fix
 ```
 
-This will format your declaration files according to the project's standards.
+The same options for targeting specific services and terms are available.