diff --git a/docs/configuring-dns.md b/docs/configuring-dns.md index ff5f05d4f..730433f06 100644 --- a/docs/configuring-dns.md +++ b/docs/configuring-dns.md @@ -1,6 +1,6 @@ # Configuring your DNS server -⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > Configuring your DNS server > [Getting the playbook](getting-the-playbook.md) > [Configuring the playbook](configuring-playbook.md) > [Installing](installing.md) +⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > Configuring your DNS server > [Getting the playbook](getting-the-playbook.md) > [Configuring the playbook](configuring-playbook.md) > [Installing](installing.md) To set up Matrix on your domain, you'd need to do some DNS configuration. @@ -105,4 +105,4 @@ To make the [postmoogle](configuring-playbook-bridge-postmoogle.md) email bridge --------------------------------------------- -When you're done with the DNS configuration and ready to proceed, continue with [Getting the playbook](getting-the-playbook.md). +[▶️](getting-the-playbook.md) When you're done with the DNS configuration and ready to proceed, continue with [Getting the playbook](getting-the-playbook.md). diff --git a/docs/configuring-playbook.md b/docs/configuring-playbook.md index 620fbca19..144d7975a 100644 --- a/docs/configuring-playbook.md +++ b/docs/configuring-playbook.md @@ -1,14 +1,8 @@ # Configuring the playbook -⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > [Configuring your DNS server](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) > Configuring the playbook > [Installing](installing.md) +⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > [Configuring your DNS server](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) > Configuring the playbook > [Installing](installing.md) -To configure the Ansible playbook, you need to have done the following things: - -- have a server where Matrix services will run -- [configured your DNS records](configuring-dns.md) -- [retrieved the playbook's source code](getting-the-playbook.md) to your computer - -You can then follow these steps inside the playbook directory: +If you've configured your DNS records and retrieved the playbook's source code to your computer, you can start configuring the playbook. To do so, follow these steps inside the playbook directory: 1. create a directory to hold your configuration (`mkdir -p inventory/host_vars/matrix.example.com` where `example.com` is your "base domain") @@ -28,7 +22,7 @@ For a basic Matrix installation, that's all you need. For a more custom setup, see the [Other configuration options](#other-configuration-options) below. -When you're done with all the configuration you'd like to do, continue with [Installing](installing.md). +[▶️](installing.md) When you're done with all the configuration you'd like to do, continue with [Installing](installing.md). ## Other configuration options diff --git a/docs/getting-the-playbook.md b/docs/getting-the-playbook.md index da155aeda..0a465399b 100644 --- a/docs/getting-the-playbook.md +++ b/docs/getting-the-playbook.md @@ -1,6 +1,6 @@ # Getting the playbook -⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > [Configuring your DNS server](configuring-dns.md) > Getting the playbook > [Configuring the playbook](configuring-playbook.md) > [Installing](installing.md) +⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > [Configuring your DNS server](configuring-dns.md) > Getting the playbook > [Configuring the playbook](configuring-playbook.md) > [Installing](installing.md) This Ansible playbook is meant to be executed on your own computer (not the Matrix server). @@ -37,4 +37,4 @@ You can extract this archive anywhere. You'll get a directory called `matrix-doc --------------------------------------------- -No matter which method you've used to download the playbook, you can proceed by [Configuring the playbook](configuring-playbook.md). +[▶️](configuring-playbook.md) No matter which method you've used to download the playbook, you can proceed by [Configuring the playbook](configuring-playbook.md). diff --git a/docs/installing.md b/docs/installing.md index 2be65a4a7..a2c54a68b 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -1,8 +1,8 @@ # Installing -⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > [Configuring your DNS server](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) > [Configuring the playbook](configuring-playbook.md) > Installing +⚡️[Quick start](README.md) | [Prerequisites](prerequisites.md) > [Configuring your DNS server](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) > [Configuring the playbook](configuring-playbook.md) > Installing -If you've [configured your DNS](configuring-dns.md) and have [configured the playbook](configuring-playbook.md), you can start the installation procedure. +If you've configured your DNS records and the playbook, you can start the installation procedure. ## Update Ansible roles diff --git a/docs/prerequisites.md b/docs/prerequisites.md index 51bc5b2f0..e0b128a35 100644 --- a/docs/prerequisites.md +++ b/docs/prerequisites.md @@ -1,6 +1,6 @@ # Prerequisites -⚡️[Quick start](README.md) | Prerequisites > [Configuring your DNS server](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) > [Configuring the playbook](configuring-playbook.md) > [Installing](installing.md) +⚡️[Quick start](README.md) | Prerequisites > [Configuring your DNS server](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) > [Configuring the playbook](configuring-playbook.md) > [Installing](installing.md) To install Matrix services using this Ansible playbook, you need: @@ -48,4 +48,4 @@ To install Matrix services using this Ansible playbook, you need: --------------------------------------------- -When ready to proceed, continue with [Configuring DNS](configuring-dns.md). +[▶️](configuring-dns.md) When ready to proceed, continue with [Configuring DNS](configuring-dns.md).