diff --git a/data/doc/documentation.xml b/data/doc/documentation.xml
index 4b8b946b..ec3ad1f9 100644
--- a/data/doc/documentation.xml
+++ b/data/doc/documentation.xml
@@ -4496,6 +4496,22 @@ git checkout v9.0.0</programlisting>
             <para>If you did not change the annotation ODD to match your own requirements, you may also want to copy <filename>odd/annotations.odd</filename>
               from TEI Publisher 9 into <filename>resources/odd/</filename> of you app</para>
           </step>
+          <step>
+            <para>To update the HTML page for annotations, it is best to use the version from TEI Publisher 9 and copy over the sections you customized. While
+              the Publisher 9 version may look very different on first sight, the relevant, user-customizable parts have not changed much:<itemizedlist>
+              <listitem>
+                <para>copy any customized toolbar buttons (class <option>annotation-action</option>) into the corresponding header element in the Publisher 9
+                  version</para>
+              </listitem>
+              <listitem>
+                <para>in the same way copy modified form controls (class <option>annotation-form</option>). In the new version those appear further down in the
+                  HTML, but still look the same</para>
+              </listitem>
+              <listitem>
+                <para>copy element <tag>pb-authority-lookup</tag>, including your custom authoritiy definitions</para>
+              </listitem>
+              </itemizedlist></para>
+          </step>
           </procedure></para>
       </section>
     </section>
diff --git a/templates/pages/annotate.html b/templates/pages/annotate.html
index c79d513e..9181fde6 100644
--- a/templates/pages/annotate.html
+++ b/templates/pages/annotate.html
@@ -42,12 +42,10 @@
                 data-template="pages:parse-params">
                 <paper-icon-button icon="icons:folder-open"></paper-icon-button>
             </a>
-            <!--paper-icon-button id="tocToggle" class="toc-toggle" icon="icons:view-list"/-->
             <pb-zoom emit="transcription" direction="in" icon="icons:zoom-in"/>
             <pb-zoom emit="transcription" direction="out" icon="icons:zoom-out"/>
         </span>
         <span class="icon-group">
-            <!--paper-icon-button id="clear-all" icon="icons:refresh"></paper-icon-button-->
             <paper-icon-button class="annotation-action authority" data-i18n="[title]annotations.person" title="Person" data-type="person" data-shortcut="⌘+⇧+p,ctrl+⇧+p" icon="social:person" disabled="disabled"></paper-icon-button>
             <paper-icon-button class="annotation-action authority" data-i18n="[title]annotations.organisation" title="organization" data-type="organization" data-shortcut="⌘+⇧+o,ctrl+⇧+o" icon="social:people" disabled="disabled"></paper-icon-button>
             <paper-icon-button class="annotation-action authority" data-i18n="[title]annotations.place" title="Place" data-type="place" icon="maps:place" data-shortcut="⌘+⇧+q,ctrl+⇧+q" disabled="disabled"></paper-icon-button>