Note that sections are linked to

mysociety · Feb 6, 2015 · 28eaad1 · 28eaad1 · garethrees · Feb 19, 2015
1 parent fbcf239
commit 28eaad1
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/docs/customising/themes.md b/docs/customising/themes.md
@@ -182,12 +182,14 @@ unused).
 
 ## Customising the help pages
 
-If you're running Alaveteli in another language, you'll want to show
+The help pages are a really important part of an Alaveteli site. If you're running Alaveteli in another language, you'll want to show
 your users localised versions of the help pages. Even if you're running
 the site in English, the default help pages in Alaveteli are taken from
 WhatDoTheyKnow, and are therefore relevant only to the UK. You should
 take these pages as inspiration, but review their content with a view to
-your jurisdiction. The important pages to customise and translate are:
+your jurisdiction.
+
+The important pages to customise and translate are listed here. We note where Alaveteli links to these pages (sometimes to anchors for particular sections within the pages) or takes users directly to them.
 
 * [About](https://github.com/mysociety/alaveteli/blob/master/app/views/help/about.html.erb): why the website exists, why it works, etc
 * [contact](https://github.com/mysociety/alaveteli/blob/master/app/views/help/contact.html.erb): how to get in touch