doc/adapting-existing: A bit more elaboration and a typo fix