mad-star-studio/element-web
2
0
Fork 0
Code Pull requests Activity

Document pull request previews

Browse source 
This documents the pull request previews we recently added when working on
https://github.com/vector-im/element-web/issues/12624.
This commit is contained in:
J. Ryan Stinnett 2020-12-09 13:59:45 +00:00
parent c41f164c75
commit ec781b3ebe
3 changed files with 35 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

32
docs/pr-previews.md Normal file
View file

@ -0,0 +1,32 @@
# Pull Request Previews
Pull requests to the React SDK layer (and in the future other layers as well)
automatically set up a preview site with a full deployment of Element with the
changes from the pull request added in so that anyone can easily test and review
them. This is especially useful for checking visual and interactive changes.
To access the preview site, scroll down to the bottom of the PR where the
various CI results are displayed:
![Pull request: checks section](./img/pr-checks.png)
The checks section could be collapsed at first, so you may need to click "Show
all checks" to reveal them. Look for an entry that mentions `deploy-preview`. It
may be at the end of the list, so you may need scroll a bit to see it. To access
the preview site, click the "Details" link in the deploy preview row.
**Important:** Please always use test accounts when logging into preview sites,
as they may contain bugs or other issues that could damage your account.
## FAQs
### Are preview sites created for pull requests from contributors?
Yes, they are created for all PRs from any author.
### Do preview sites expire after some time period?
No, there is no expiry date, so they should remain accessible indefinitely, but
of course they obviously aren't meant to live beyond the development workflow,
so please don't rely on them for anything important. They may disappear at any
time without notice.