Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rephrased the instruction to configure app in readme.md and contributing.md #21673

Closed
wants to merge 5 commits into from
Closed

Rephrased the instruction to configure app in readme.md and contributing.md #21673

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
3ac7388
doc/clarify-readme
bolu-tife Apr 4, 2022
5ed72f7
doc/clarify-dev-environment-instruction
bolu-tife Apr 4, 2022
7819975
Update README.md
bolu-tife Apr 22, 2022
bdee321
Update config.md
bolu-tife Apr 22, 2022
7f0ba3e
Update config.md
bolu-tife Apr 22, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 12 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,9 @@ released version of Element:
1. Untar the tarball on your web server
1. Move (or symlink) the `element-x.x.x` directory to an appropriate name
1. Configure the correct caching headers in your webserver (see below)
1. Configure the app by copying `config.sample.json` to `config.json` and
modifying it. See the [configuration docs](docs/config.md) for details.
1. Configure the app by making a copy of the `config.sample.json` and renaming it as
`config.json` within the same directory. You can also customize it. See the
[configuration docs](docs/config.md) for details.
1. Enter the URL into your browser and log into Element!

Releases are signed using gpg and the OpenPGP standard, and can be checked against the public key located
Expand Down Expand Up @@ -132,9 +133,10 @@ guide](https://classic.yarnpkg.com/en/docs/install) if you do not have it alread
environment](#setting-up-a-dev-environment) below). Alternatively, you
can use <https://develop.element.io> - the continuous integration release of
the develop branch.
1. Configure the app by copying `config.sample.json` to `config.json` and
modifying it. See the [configuration docs](docs/config.md) for details.
1. `yarn dist` to build a tarball to deploy. Untaring this file will give
1. Configure the app by making a copy of the `config.sample.json` and renaming it as
`config.json` within the same directory. You can also customize it. See the
[configuration docs](docs/config.md) for details.
Comment on lines +137 to +138
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the indentation here appears to have been lost

3. `yarn dist` to build a tarball to deploy. Untaring this file will give
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

to fit the surrounding document, this would also be numbered at 1

a version-specific directory containing all the files that need to go on your
web server.

Expand Down Expand Up @@ -311,9 +313,12 @@ Clone the repo and switch to the `element-web` directory:
git clone https://github.com/vector-im/element-web.git
cd element-web
```
The `matrix-js-sdk`, `matrix-react-sdk` and `element-web` folders should be at the same level.

Configure the app by copying `config.sample.json` to `config.json` and
modifying it. See the [configuration docs](docs/config.md) for details.

Configure the app by making a copy of the `config.sample.json` and renaming it as
`config.json` within the same directory. You can also customize it.
See the [configuration docs](docs/config.md) for details.

Finally, build and start Element itself:

Expand Down
6 changes: 3 additions & 3 deletions docs/config.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Configuration

You can configure the app by copying `config.sample.json` to `config.json` and customising it. The possible options are
described here. If you run into issues, please visit [#element-web:matrix.org](https://matrix.to/#/#element-web:matrix.org)
on Matrix.
You can configure the app by making a copy of the `config.sample.json` and renaming it as `config.json`
within the same directory. The possible options are described here. If you run into issues, please visit
[#element-web:matrix.org](https://matrix.to/#/#element-web:matrix.org) on Matrix.

For a good example of a production-tuned config, see https://app.element.io/config.json

Expand Down