Add CI jobs to build docs (#6413)
authorGereon Kremer <gkremer@stanford.edu>
Mon, 3 May 2021 19:21:19 +0000 (21:21 +0200)
committerGitHub <noreply@github.com>
Mon, 3 May 2021 19:21:19 +0000 (19:21 +0000)
commit009ae6e41ace0a80923e02941a0bbc80de6e84f1
tree3a8f4373943c0278cf5c9e666fd100761ff070ec
parentfc98e575192e6a07e0cb56118d8800ee7c98c6a0
Add CI jobs to build docs (#6413)

This PR adds CI jobs to automatically build documentation for branches on the main repository and for pull request.
The first job builds the documentation for every push and pr and stores the generated documentation in cvc5.github.io/docs-ci. All versions are stored and for every branch and PR a symbolic link to the most recent version is maintained.
Note that the PR jobs are run by the pull_request_target trigger that allows access to repository secrets, but runs in the context of the target branch and we thus need to (carefully!) pull in the relevant changes manually.
The second job runs once a week and prunes the docs-ci repository: all directories that have not been touched for a month are removed, and all commits older than a month are squashed into a single commit. This retains the full history for the last month, but effectively removes everything older than that.
.github/workflows/docs_cleanup.yml [new file with mode: 0644]
.github/workflows/docs_update.yml [new file with mode: 0644]