use inline defined hints

1 files changed, 17 insertions, 8 deletions

diff --git a/USE.md b/USE.md
index 62014be..0e44425 100644
--- a/USE.md
+++ b/USE.md
@@ -1,18 +1,27 @@
 # Setting up your personal email account
 
-As a user at [[!template id=realm]] you have been given a single [[account]].
+As a user at Example orga you have been given a single [[account]].
 Tied to this account is an email address (or possibly more than one).
 
 All incoming emails are delivered to the inbox of your personal account (ie.
 same location no matter if you have more addresses attached).
 
 
+## Special strings
+
+NB! This documentation includes the following special strings
+used e.g. when generating a documentation website:
+
+organisation: Example orga
+webmailhost: mail.example.org
+
+
 ## Webmail setup
 
 Webmail is probably the simplest way to reach your emails. Somewhat like
 HoTMaiL but without advertisements.
 
-The website [[!template id=webmailurl]] offers several webmail applications,
+The website <https://mail.example.org/> offers several webmail applications,
 each with different strengths and weaknesses.
 
 The topmost of the webmail applications, IMP, is recommended, due to its most
@@ -20,13 +29,13 @@ complete functionality. It provides access to changing your account
 [[password]].
 
 Same website also lists some alternative websites also offering webmail access
-to accounts at [[!template id=realm]]. Save those addresses on your own
+to accounts at Example orga. Save those addresses on your own
 computer, for the case of the primary webmail service one day being out of
 order.
 
 Entering webmail, step by step:
 
- 1. Go to [[!template id=webmailurl]]
+ 1. Go to <https://mail.example.org/>
  2. Pick the topmost webmail application, IMP
  3. Login using your personal username and password
 
@@ -49,7 +58,7 @@ puts less burden on the server.
     less flexible - e.g. does not work well concurrently with webmail access to
     your emails.
 
- 3. Use your provided username and **[[!template id=mailhost]]** as both
+ 3. Use your provided username and **mail.example.org** as both
     incoming and outgoing server
  4. Enable encryption for incoming mail (imap or pop3):
     * Enable "SSL" (also called "secure connection")
@@ -72,8 +81,8 @@ that the configuration produced match the above instructions.
 "advanced settings" or similar.
 
 Your email application might complain that it does not trust the mail server.
-You then need to accept the "security certificate" used at [[!template
-id=realm]] (see external reference to riseup.net at the bottom of this page).
+You then need to accept the "security certificate" used at Example orga
+(see external reference to riseup.net at the bottom of this page).
 Mozilla Thunderbird need no special handling.
 
 
@@ -93,7 +102,7 @@ If you use Apple Mail, you need to avoid filling up your
 ## External links
 
 The help texts at riseup.net is generally good, as their system works much like
-this. Just remember to use **[[!template id=mailhost]]** whenever
+this. Just remember to use **mail.example.org** whenever
 "mail.riseup.net" is mentioned.
 
  * [Setting up email applications](http://help.riseup.net/mail/mail-clients/)