As mentioned in D4015#91200, the number of writing and markup guidelines for Blender Manual editors is currently very large and not clear in all places, so here is my attempt at condensing the writing guide part. Any comments? @Aaron Carlisle (Blendify), @Tobias Heinke (TobiasH), @Inês Almeida (brita_), @Brecht Van Lommel (brecht) , anyone else?
Seems all reasonable to me, but would be good if someone more active in the manual would look at this.
Aim -> The aim
from the manual style
I don't think every deviation needs to be commented, maybe only in a few rare cases. Would not have this as a rule.
Avoid documenting -> Don't document
or include them -> or included
for user -> for the user
Glossary section -> The glossary section
meaning -> the meaning
term -> the term
I could add a comment to almost ever single line (Why are you: altering the meaning, remove examples/explanations, the reshuffling, removal of rules..)
You're turning it into a cheat sheet.
Yes, it improves the wording. I'm sorry but your not experienced enough (yet) to rewrite the guide.
For me it has no high priority, so I'll add this to my todo list.