Problem: AMAUAT docs can potentially be simplified and should include black-box tests

[ross-spencer]

Version of the documentation

Current documentation as of 1.10.

Page (and section, if applicable) where the issue occurs

There are three main components to the acceptance test documentation:

• README
• Running experiments
• Developer documentation

Description of the issue

There is a lot of information in the docs, but not all is relevant to get up and running quickly. It is hard to get an indicator about the importance of the tests to Archivematica development, especially with the new black-box functionality.

Suggested fix

I feel there are three areas to focus on as we continue the AMAUAT improvement work:

1. Include the black-box tests and how to run them (there is some proposed text in the 1.10 release notes that can potentially be migrated into the README).
2. Make it as simple as possible for community contributors to see how to run the tests against their changes.
3. Continue to review the docs for accuracy. With only tweaks to the tests for 1.10 there do not seem to be any substantial problems with the docs at present.
4. Further simplification of the docs, e.g. to make them easier to maintain; to deliver the most important information as simply as possible.

See also: artefactual-labs/archivematica-acceptance-tests#146 (comment)

Related to #571
Related to artefactual-labs/archivematica-acceptance-tests#46