diff --git a/doc/icecast2_config_file.html b/doc/icecast2_config_file.html
index 56f6acdd..7a982cfb 100644
--- a/doc/icecast2_config_file.html
+++ b/doc/icecast2_config_file.html
@@ -29,6 +29,20 @@ This section will describe each section of the config file and is grouped into t
 <br />
 <br />
 </p>
+<h2>A word of warning</h2>
+<p>
+Please note that, especially for new Icecast users, editing the config file can be quite tricky. <strong>It is thus recommended to start by just changing all passwords, nothing else.</strong> You can then use the source-password to bring up an initial stream and get more comfortable with how Icecast works.
+</p>
+<p>
+Should you need to customize the configuration, then make a backup of your working config file, before you make any changes. If Icecast refuses to start it is in most cases due to a malformed config file. In such a case running the following command should point out most XML syntax problems.
+<pre>xmllint icecast.xml</pre>
+Also check the Icecast error.log for additional hints.
+</p>
+<p>
+<br />
+<br />
+<br />
+</p>
 <a name="limits"></a>
 <h2>Limits</h2>
 <pre>