Improve PING_EMAIL_DOMAIN docs some more :-)

static/css/docs.css

@@ -176,7 +176,7 @@ h2.rule {
     padding: 0;
 }
 
-.page-docs h2:target code {
+.page-docs .self-hosted-configuration-toc ~ h2:target code {
     display: inline-block;
     color: #333;
     background: #ffef82;

templates/docs/self_hosted_configuration.html-fragment

@@ -307,21 +307,22 @@ it altogether by setting this value to <code>None</code>.</p>
 <h2 id="PING_EMAIL_DOMAIN"><code>PING_EMAIL_DOMAIN</code></h2>
 <p>Default: <code>localhost</code></p>
 <p>The domain to use for generating ping email addresses. Example:</p>
-<div class="highlight"><pre><span></span><code><span class="na">PING_EMAIL_DOMAIN</span><span class="o">=</span><span class="s">ping.my-hc.example.org</span>
+<div class="highlight"><pre><span></span><code><span class="na">PING_EMAIL_DOMAIN</span><span class="o">=</span><span class="s">hc.example.org</span>
 </code></pre></div>
 
 <p>In this example, Healthchecks would generate ping email addresses similar
-to <code>3f1a7317-8e96-437c-a17d-b0d550b51e86@ping.my-hc.example.org</code>.</p>
+to <code>3f1a7317-8e96-437c-a17d-b0d550b51e86@hc.example.org</code>.</p>
 <p>This setting only controls how the ping email addresses are constructed, and
 does not by itself enable the ping-by-sending-email functionality. To receive
 emails, you will also need:</p>
 <ul>
-<li>A DNS record pointing <code>ping.my-hc.example.org</code> to your Healthchecks
+<li>A DNS record pointing <code>hc.example.org</code> to your Healthchecks
   instance's IP address.</li>
 <li><code>manage.py smtpd</code> (Healthchecks' SMTP listener service) running, listening
   on port 25, and reachable from the outside world. If you are using the
   <a href="https://hub.docker.com/r/healthchecks/healthchecks">official Docker image</a>,
-  see <a href="https://github.com/healthchecks/healthchecks/tree/master/docker#smtp-listener-configuration-via-smtpd_port">the instructions here</a> for enabling the SMTP listener service.</li>
+  see <a href="../self_hosted_docker/#SMTPD_PORT">the instructions here</a> for enabling the SMTP
+  listener service.</li>
 </ul>
 <h2 id="PING_ENDPOINT"><code>PING_ENDPOINT</code></h2>
 <p>Default: <code>SITE_ROOT</code> + <code>/ping/</code></p>

templates/docs/self_hosted_configuration.md

@@ -443,22 +443,23 @@ Default: `localhost`
 The domain to use for generating ping email addresses. Example:
 
 ```ini
-PING_EMAIL_DOMAIN=ping.my-hc.example.org
+PING_EMAIL_DOMAIN=hc.example.org
 ```
 
 In this example, Healthchecks would generate ping email addresses similar
-to `3f1a7317-8e96-437c-a17d-b0d550b51e86@ping.my-hc.example.org`.
+to `3f1a7317-8e96-437c-a17d-b0d550b51e86@hc.example.org`.
 
 This setting only controls how the ping email addresses are constructed, and
 does not by itself enable the ping-by-sending-email functionality. To receive
 emails, you will also need:
 
-* A DNS record pointing `ping.my-hc.example.org` to your Healthchecks
+* A DNS record pointing `hc.example.org` to your Healthchecks
   instance's IP address.
 * `manage.py smtpd` (Healthchecks' SMTP listener service) running, listening
   on port 25, and reachable from the outside world. If you are using the
   [official Docker image](https://hub.docker.com/r/healthchecks/healthchecks),
-  see [the instructions here](https://github.com/healthchecks/healthchecks/tree/master/docker#smtp-listener-configuration-via-smtpd_port) for enabling the SMTP listener service.
+  see [the instructions here](../self_hosted_docker/#SMTPD_PORT) for enabling the SMTP
+  listener service.
 
 ## `PING_ENDPOINT` {: #PING_ENDPOINT }
 

templates/docs/self_hosted_docker.html-fragment

@@ -54,10 +54,10 @@ variables in <code>docker/.env</code>. For example, to disable HTTP request logg
 </code></pre></div>
 
 <p>Read more about configuring uWSGI in <a href="https://uwsgi-docs.readthedocs.io/en/latest/Configuration.html#environment-variables">uWSGI documentation</a>.</p>
-<h2>SMTP Listener Configuration via <code>SMTPD_PORT</code></h2>
+<h2 id="SMTPD_PORT">SMTP Listener Configuration via <code>SMTPD_PORT</code></h2>
 <p>Healthchecks comes with a <code>smtpd</code> management command, which runs a SMTP listener
 service. With the command running, you can ping your checks by sending email messages
-to <code>your-uuid-here@your-hc-domain.com</code> email addresses.</p>
+to <code>your-uuid-here@hc.example.org</code> email addresses.</p>
 <p>The container is configured to start the SMTP listener conditionally, based
 on the value of the <code>SMTPD_PORT</code> environment value:</p>
 <ul>
@@ -68,6 +68,8 @@ on the value of the <code>SMTPD_PORT</code> environment value:</p>
 </ul>
 <p>The conditional logic lives in uWSGI configuration file,
 <a href="https://github.com/healthchecks/healthchecks/blob/master/docker/uwsgi.ini">uwsgi.ini</a>.</p>
+<p>See also: the <a href="../self_hosted_configuration/#PING_EMAIL_DOMAIN">PING_EMAIL_DOMAIN</a>
+environment variable for customizing the domain part of the email addresses.</p>
 <h2>TLS Termination</h2>
 <p>If you plan to expose your Healthchecks instance to the public internet, make sure you
 put a TLS-terminating reverse proxy or load balancer in front of it.</p>

templates/docs/self_hosted_docker.md

@@ -50,11 +50,11 @@ To adjust the number of uWSGI processes (for example, to save memory), set:
 
 Read more about configuring uWSGI in [uWSGI documentation](https://uwsgi-docs.readthedocs.io/en/latest/Configuration.html#environment-variables).
 
-## SMTP Listener Configuration via `SMTPD_PORT`
+## SMTP Listener Configuration via `SMTPD_PORT` {: #SMTPD_PORT }
 
 Healthchecks comes with a `smtpd` management command, which runs a SMTP listener
 service. With the command running, you can ping your checks by sending email messages
-to `your-uuid-here@your-hc-domain.com` email addresses.
+to `your-uuid-here@hc.example.org` email addresses.
 
 The container is configured to start the SMTP listener conditionally, based
 on the value of the `SMTPD_PORT` environment value:
@@ -67,6 +67,9 @@ on the value of the `SMTPD_PORT` environment value:
 The conditional logic lives in uWSGI configuration file,
 [uwsgi.ini](https://github.com/healthchecks/healthchecks/blob/master/docker/uwsgi.ini).
 
+See also: the [PING_EMAIL_DOMAIN](../self_hosted_configuration/#PING_EMAIL_DOMAIN)
+environment variable for customizing the domain part of the email addresses.
+
 ## TLS Termination
 
 If you plan to expose your Healthchecks instance to the public internet, make sure you