diff options
| author | Andrew Morgan <1342360+anoadragon453@users.noreply.github.com> | 2021-06-24 18:00:56 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-06-24 18:00:56 +0100 |
| commit | f0e02f5df2bc3ae779ac8c18578deebdfecc7e97 (patch) | |
| tree | a97b64753d5cd957e7f82d2d677903a8dce7efd0 /changelog.d | |
| parent | Return errors from `send_join` etc if the event is rejected (#10243) (diff) | |
| download | synapse-f0e02f5df2bc3ae779ac8c18578deebdfecc7e97.tar.xz | |
Create an index.html file when generating a docs build (#10242)
Currently when a new build of the docs is created, an `index.html` file does not exist. Typically this would be generated from a`docs/README.md` file - which we have - however we're currently using [docs/README.md](https://github.com/matrix-org/synapse/blob/394673055db4df49bfd58c2f6118834a6d928563/docs/README.md) to explain the docs and point to the website. It is not part of the content of the website. So we end up not having an `index.html` file, which will result in a 404 page if one tries to navigate to `https://matrix-org.github.io/synapse/<docs_version>/index.html`. This isn't a really problem for the default version of the documentation (currently `develop`), as [navigating to the top-level root](https://matrix-org.github.io/synapse/) of the website (without specifying a version) will [redirect](https://github.com/matrix-org/synapse/blob/a77e6925f26597958eccf0ef9956cb13c536e57e/index.html#L2) you to the Welcome and Overview page of the `develop` docs version. However, ideally once we add a GUI for switching between versions, we'll want to send the user to `matrix-org.github.io/synapse/<version>/index.html`, which currently isn't generated. This PR modifies the CI that builds the docs to simply copy the rendered [Welcome & Overview page](https://matrix-org.github.io/synapse/develop/welcome_and_overview.html) to `index.html`.
Diffstat (limited to 'changelog.d')
| -rw-r--r-- | changelog.d/10242.doc | 1 |
1 files changed, 1 insertions, 0 deletions
diff --git a/changelog.d/10242.doc b/changelog.d/10242.doc new file mode 100644 index 0000000000..2241b28547 --- /dev/null +++ b/changelog.d/10242.doc @@ -0,0 +1 @@ +Choose Welcome & Overview as the default page for synapse documentation website. |