Agoric / documentation

User documentation
https://agoric.com/documentation/
Apache License 2.0
14 stars 38 forks source link

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

Open LuqiPan opened 3 months ago

LuqiPan commented 3 months ago

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
- [ ] https://github.com/Agoric/documentation/issues/1042
- [ ] https://github.com/Agoric/documentation/issues/1043
- [ ] https://github.com/Agoric/documentation/issues/1044
- [ ] https://github.com/Agoric/documentation/issues/1045