be more explicit.

[fkr]

addresses feedback from #840

[fkr]

the linter issue is addressed in #1015

[garloff]

github's markdown link checker seems to be picky to resolve links to github.com/.../tree/... I tend to ignore this, as the links are functional. But: Maybe there is an ongoing change where this should be handled differently? If so, we should IMVHO do the cleanup patches independently from content improvements such as this patch, so I would still merge ...