docs: update the docs for 1.20

Add a section 'modernizing' that helps to decide which verison to require for which feature.
Expand the markdown support a little.