Change .asciidoc to more standard and shorter .adoc.

This potentially breaks some links to workflow in master from outside
but in general is has to happen to be consistent with other projects and
future changes in them.