doc: various wording improvements and link fixes from Dayo Akanji.