External Doc Reorganization

See merge request !45

Update docs/tutorials/PersonAPI/PersonAPIwRESTv2.md, docs/tutorials/PersonAPI/images/SwaggerDone.png, docs/tutorials.md

Update docs/tutorials/PersonAPI/swagger.json, docs/tutorials/PersonAPI/PersonAPIwRESTv2.md, docs/tutorials/PersonAPI/images/SwaggerCreation.png

Update docs/best-practices/flat-file-alternative.md, docs/best-practices/cai-vs-cdi.md, docs/best-practices.md, README.md, docs/secure-agent.md

Deleted howto.md

Supplements Training Documentation with Additional Information

See merge request !44

reference the supplemental training information in one of the documents so that people might actually see it

Attempt to fix most broken links / redirect a few references to external documentation into new internal documentation

Swagger files change link checker config

See merge request !43