19215: Incorporate many details into install doc

[arvados.git] / doc / _includes / _ssl_config_multi.liquid

diff --git a/doc/_includes/_ssl_config_multi.liquid b/doc/_includes/_ssl_config_multi.liquid
index 1bcd1b64ef3a4ba055da2caf4cd1fcc00a9fa5de..d001a5f228903d92d6c2287a42da8898cd6ec954 100644 (file)
--- a/doc/_includes/_ssl_config_multi.liquid
+++ b/doc/_includes/_ssl_config_multi.liquid
@@ -8,9 +8,9 @@ h2(#certificates). Choose the SSL configuration (SSL_MODE)
 
 Arvados requires an SSL certificate to work correctly. This installer supports these options:
 
-* @self-signed@: let the installer create self-signed certificates
-* @lets-encrypt@: automatically obtain and install an SSL certificates for your hostnames
-* @bring-your-own@: supply your own certificates in the `certs` directory
+# @self-signed@: "let the installer create self-signed certificates":#self-signed
+# @lets-encrypt@: "automatically obtain and install an SSL certificates for your hostnames":#lets-encrypt
+# @bring-your-own@: "supply your own certificates in the @certs@ directory":#bring-your-own
 
 h3(#self-signed). Using self-signed certificates
 
@@ -21,7 +21,7 @@ To make the installer use self-signed certificates, change the configuration lik
 </code></pre>
 </notextile>
 
-When connecting to the Arvados web interface for the first time, you will need to accept the self-signed certificates as trusted to bypass the browser warnings. This can be a little tricky to do. Alternatively, you can also install the self-signed root certificate in your browser, see <a href="#ca_root_certificate">below</a>.
+Before connecting to the Arvados web interface for the first time, anyone accessing the instance will need to "install the self-signed root certificate in their browser.":#ca_root_certificate
 
 h3(#lets-encrypt). Using a Let's Encrypt certificate