Various documentation update for new appfw

https://phabricator.apertis.org/T8426

Actually split into multiple commits this time so it should be (semi-)reviewable. (I am aware that my editor stripped trailing whitespace, but trailing whitespace is evil anyway; in the review UI, you can hit the tear towards the top right -> uncheck "Show whitespace changes" to ignore those.)