Centralize and update test documentation - Part 1 Explanation section

[Ndacyayisenga-droid]

Fixes part of #1558

[smlambert]

Thanks @Ndacyayisenga-droid - can you also create a pages dir inside of docs to mimic what is currently in smlambert.github.io ? (with these 4 pages inside of it). That layout and all of the extra files inside of https://github.com/smlambert/smlambert.github.io/tree/main/docs are used to serve up the documentation (as seen at https://smlambert.github.io/).

Once we have that structure in place, we can start adding more pages, and linking them off of the 4 main categories as appropriate.

[smlambert]

hi @Ndacyayisenga-droid - thanks for pulling this together.

These 4 pages that you are adding will contain lists and denote the 4 types of documents we will have in the project. Under the "aqa-explanation" category which should be answering "why", I think we will have 3 separate docs linked from the aqa-explanation page (mentioned in #1558 (comment))

• AQAvit manifesto (which can stay in its own document as it is now, Manifesto.md, but get moved from doc dir into into the docs/pages dir)
• Scope of AQAvit (which I can write and can be in its own doc /docs/pages/Scope.md)
• Why the '3 layer cake' architecture (which can be its own doc /docs/pages/LayeredDesign.md and feature a diagram of the 3 functional layers of AQAvit and what purpose each layer serves)

[smlambert]

Here is my first round of reviews @Ndacyayisenga-droid

[smlambert]

hi @Ndacyayisenga-droid - let's move this one out of draft

[sendaoYan]

/LGTM

[smlambert]

A couple of extra comments to address prior to merging.