Deprecation banner, take two.

Added the deprecation banner to all documentation, like before, but this time preserving the existing HTML markup.

Commits were also separated this time to make it easier to perform a diff within GitHub, so this time it should be a lot neater to double check.