CI/CD to ensure endo, agoric-sdk references in docs site is up-to-date and error-free

[LuqiPan]

With the introduction of #1038 and as we work towards #927, we enter a world where the build and publication of docs.agoric.com depends on both Agoric/agoric-sdk and endojs/endo repos.

Once #1038 is complete, we'll have Agoric/documentation pulling from and building reference docs for both Agoric/agoric-sdk and endojs/endo repos whenever PRs are open or merged into Agoric/documentation repo.

However, docs site won't update when changes are made to Agoric/agoric-sdk and endojs/endo repos, nor will doc errors surface when we run yarn typedoc-markdown in Agoric/agoric-sdk or endojs/endo repo. Instead, we'd need to checkout both repos, then convert the .md files, generated by yarn typedoc-markdown, to html, css, etc using vitepress in Agoric/documentation repo in order to find errors and deploy to docs site. Below is a list of tasks to close this gap.

Trigger	Repo	Goal	Issue
Open a PR	Agoric/agoric-sdk	Verify docs site still builds	#1044
Merge a PR	Agoric/agoric-sdk	Deploy to docs site with new changes	#1042
Open a PR	endojs/endo	Verify docs site still builds	#1045
Merge a PR	endojs/endo	Deploy to docs site with new changes	#1043

Tasks

Beta Give feedback

1. CI: automatically trigger a deployment to docs.agoric.com whenever something is merged into agoric-sdk repo #1042
   api-docs +1
2. CI: automatically trigger a deployment to docs.agoric.com whenever something is merged into endo repo #1043
   api-docs +1
3. CI(integration-test): PRs in agoric-sdk should automatically trigger a verification that docs.agoric.com site still builds #1044
   api-docs +1
4. CI(integration-test): PRs in endo should automatically trigger a verification that docs.agoric.com site still builds #1045
   api-docs +1