You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
matrix-spec-proposals/scripts
Andrew Morgan a17023962c Update CircleCI and Buildkite configs to build the new spec (#3017)
This PR attempts to update the CI of matrix-doc to build [the new spec redesign](https://github.com/matrix-org/matrix-doc/issues/2906). It does so by additionally building the new spec in parallel to the old. The plan is to continue to host the old spec at https://matrix.org/docs/spec, while the new spec will be at https://spec.matrix.org. Eventually we will retire the old version of the spec, and have the old URL redirect to the new one.

In detail, this PR:
* Adds a new step to CircleCI to build the new spec with `hugo`. This step uses alpine, grabs some dependencies, and then builds the HTML.
  * We needed to hand some specific options to hugo for CircleCI in order to continue allowing CircleCI to host temporary builds of the spec after each CI run. This required changing some assumptions related to relative paths.
  * CircleCI's artifacts hosting is also quite limited. Specifically it will not automatically resolve `/some/path` to `/some/path/index.html`, which our hugo theme relied on. Fixes were implemented for this, but we may want to consider switching away from CircleCI artifacts as a host, and using something like [netlify](https://www.netlify.com/) instead.
* Modifies the existing Buildkite pipeline step to build both the new spec in a separate step. It additionally modifies the old spec to be built with alpine. (Separate out into another PR)
  * We'd like to separate out the deployment of matrix.org from the new spec. Therefore a new step, with a separate artifact build (`spec.tar.gz`). We will eventually remove the old step and the matrix.org build trigger.
* Modifies `pyproject.toml` to update the config of [giles](https://github.com/OpenAstronomy/baldrick/blob/master/baldrick/plugins/circleci_artifacts.py), which is what creates the "docs", "swagger" links in the CI steps for matrix-docs PRs.
  * A new step was added for the new spec. The old spec was renamed to "legacy".
3 years ago
..
continuserv Spec SAS verification and the common key verification framework 6 years ago
contrib Add a nix-shell environment suitable for building 8 years ago
css Suppress bullets inside table of contents 4 years ago
speculator Add a bunch more people to the speculator trusted list 6 years ago
templating Document top-level UnsignedData objects 5 years ago
check-event-schema-examples.py Move raw API and event schemas into /data directory 3 years ago
check-swagger-sources.py Update checker scripts to work correctly from the scripts/ dir 3 years ago
dump-swagger.py Update path to Swagger files 3 years ago
gendoc.py Incorporate MSC2209 (`notifications` auth rules) 5 years ago
generate-matrix-org-assets Update CircleCI and Buildkite configs to build the new spec (#3017) 3 years ago
i18n.py Update i18n for emoji 4 years ago
package.json Move validator.js to scripts/ directory, update calls 3 years ago
proposals.js Support rendering of proposal tables 3 years ago
proposals.py improve capture and add example 5 years ago
requirements.txt jenkins is dead, long live buildkite 6 years ago
swagger-http-server.py Convert build scripts to python 3 6 years ago
test-and-build.sh Move validator.js to scripts/ directory, update calls 3 years ago
validator.js Move validator.js to scripts/ directory, update calls 3 years ago