1/ Many internal links in the content were broken due to the changes in
the markdown processing from mdtext to html.
What's changed is that generated links use "-" for space (not "_"),
lowercase is used for everything and it drops non-alphanumerics.
I'm done a wholesale fixing of the website by scanning for candidate
broken links and fixing.
# Upper case
find . -name \*mdtext -print | xargs grep -l '(#[^)]*[A-Z][^)]*)'
# Underscore
find . -name \*mdtext -print | xargs grep -l '(#.*_.*)'
and now, hopefully, things are much better.
It's a lot of change and the chances of missing something are rather too
high. If you have a moment, please check staging - pick a few pages and
see if the links in the main content area work. You may need to refresh
as the caching is quite long.
2/ style tweak
Separately ad independently, while in the area, I changed the
line-height of the content area so the lines are more widely spaced. On
pages with large paragraphs, I found the text less readable with the
default line height. This is made worse on my machines because Ubuntu's
arial/helvetica does not display very well (it's over anti-aliased
leading to a less crisp glyphs).
Andy