It looks like we're heading towards a breaking release. We should try doing as many breaking changes together as possible, to make our lives easier. Right now I can think of these (but additional suggestions are very welcome):

• Changing makedocs(format=:html)
• Changing deploydocs(julia=...). (Make deploydocs(julia=...) mandatory #526 / Default deploydocs to release #466; depwarn in Make julia a required kwarg in deploydocs #712)
• Don't use the release-x.y directories. (stop deploying to the release- folder #706)
• Other versioning changes (ref: Changes to docs deployment conventions JuliaLang/julia#26825, Add selector argument to deploydocs #813)
• Remove julia and osname arguments to deploydocs() and promote Travis build stages instead ( Remove julia and osname kwarg from deploydocs #816)
• Update message (https://discourse.julialang.org/t/displaying-an-update-message/12577) -- problematic with new Pkg.

Additional non-coding tasks we need to do before we can release this:

• Automated PRs against METADATA packages using Documenter.
• Need to ANN this on Discourse, ideally a reasonable time before the release hits METADATA.

The automated PRs could just add an upper bound to Documenter's Pkg.add. We could also consider actually making the necessary fixes to make.jl etc.

We also need to tag the new packages:

• DocumenterTools.jl
• DocumenterMarkdown.jl
• DocumenterLaTeX.jl