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.

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

Update docs/installing.md #3761

Merged
merged 14 commits into from
Nov 9, 2024
Merged

Update docs/installing.md #3761

merged 14 commits into from
Nov 9, 2024

Conversation

luixxiul
Copy link
Collaborator

@luixxiul luixxiul commented Nov 8, 2024

The main intention of this PR is:

  • Reduce the amount of information on docs/installing.md by moving the nicely detailed section for playbook tags into a dedicated page

  • Add a hint of finalizing the installation by explaining the simplest way of configuring Service Discovery, which is to use the variable matrix_static_files_container_labels_base_domain_enabled on the server dedicated for the Matrix installation.

    Currently this information cannot be found until you dig the article docs/configuring-well-known.md and then docs/configuring-playbook-base-domain-serving.md.

Suguru Hirahara added 8 commits November 9, 2024 03:28
The instruction describes the easiest way of configuring Service Discovery (which is required for federation) should help to understand what basically to be done to finalize the installation.

Signed-off-by: Suguru Hirahara <[email protected]>
…" under "Things to do next"

Maintenance work by running the playbook will be required after finalizing the installation

Signed-off-by: Suguru Hirahara <[email protected]>
… the headers

Remove nagivations for simplicity.

Signed-off-by: Suguru Hirahara <[email protected]>
The playbook tags are not limited to installation, and the explanation's detail makes the section worth being split to a dedicated individual page.

Signed-off-by: Suguru Hirahara <[email protected]>
Also: mention running "just" role on maintainance

Signed-off-by: Suguru Hirahara <[email protected]>
…llation of required software

Until recently there have been a lot of questions about installing, which could have been avoided if required software such as compatible version of Ansible was installed. This note should encourage those who experience basic error to troubleshoot before giving up.

Signed-off-by: Suguru Hirahara <[email protected]>

However, if you do not need the base domain (`example.com`) for anything else, the easiest way of configuring it is to [serve the base domain](configuring-playbook-base-domain-serving.md) from the integrated web server. It will enable you to use a Matrix user identifier like `@<username>:example.com` while hosting services on a subdomain like `matrix.example.com`.
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I think this should be correct according to this line, but I am not perfectly sure.

Suguru Hirahara added 4 commits November 9, 2024 03:54
Matrix is a name of the protocol and it does not really make sense to install it.

Signed-off-by: Suguru Hirahara <[email protected]>
…laybook command

The concept of the just recipe is explained at the bottom of the page, therefore it should be safe to avoid using it here and prefer the ansible-playbook command like above.

Signed-off-by: Suguru Hirahara <[email protected]>
@luixxiul luixxiul added the docs This issue is related to documentation label Nov 9, 2024
Copy link
Owner

@spantaleev spantaleev left a comment

Choose a reason for hiding this comment

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

Thanks! This is much tidier!

docs/installing.md Outdated Show resolved Hide resolved
docs/installing.md Outdated Show resolved Hide resolved
luixxiul and others added 2 commits November 9, 2024 17:33
Co-authored-by: Slavi Pantaleev <[email protected]>
Co-authored-by: Slavi Pantaleev <[email protected]>
@spantaleev spantaleev merged commit 9208686 into spantaleev:master Nov 9, 2024
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs This issue is related to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants