Import docs from cht-core

[abbyad]

The API docs should be ported over to the doc site.

[abbyad]

Updating issue to review, import and/or update all relevant docs from cht-core.

• README.md
• api/README.md
• release-notes/README.md
• scripts/conflicts/README.md
• scripts/poe/README.md
• scripts/po-editor-importer/readme.md
• sentinel/README.md
• shared-libs/search/README.md
• shared-libs/transitions/src/lib/pupil/README.md
• tests/scalability/README.md

[garethbowen]

README.md

Much of this should be migrated to the docs site, but we need to have something at the root level. Maybe a brief introduction and then links to the docs?

api/README.md

Move the API documentation to the docs site, and put the migrations and other internal details in code comments.

release-notes/README.md

Leave this where it is - it's just an index of all the different versions. We could consider moving all the release notes to the docs site at some point.

scripts/**/README.md

Leave these where they are.

sentinel/README.md

This is mostly outdated and I think should just be deleted.

shared-libs/search/README.md

This is internal API documentation so should be moved to the code as jsdoc comments.

shared-libs/transitions/src/lib/pupil/README.md

This is the readme of a library that we inlined and then modified, so it's irrelevant. Leave it where it is. One day I hope to replace it with the version in npm...

tests/scalability/README.md

Move this to the docs site. We should consider finding and moving all the testing resources (example) into the new docs site too as QA reference. Maybe this is a separate issue...