diff --git a/documentation/guidelines/docs_writing_guidelines.rst b/documentation/guidelines/docs_writing_guidelines.rst index 61955f2..8d39dd4 100644 --- a/documentation/guidelines/docs_writing_guidelines.rst +++ b/documentation/guidelines/docs_writing_guidelines.rst @@ -119,18 +119,18 @@ The progressive forms describe continuous actions. E.g. "is calling", Vector2 move ( Vector2 rel_vec ) Moves the body in the vector's direction. The body **stops** if it collides with an obstacle. [...] -Exception: If the subject is not clear, replacing "ing" verbs is not an -improvement. For example, in the previous sentence, "it replaces" -would not make much sense where "replacing" currently is. +If the subject is not clear, replacing the "ing" verb is not an automatic +improvement. For example, in the above **Don't** sentence, "it stops" +would not make much sense where "stopping" currently is. -You may use the progressive tense to describe actions that are -continuous in time. Anything like animation or coroutines. +Exception: You may use the progressive tense to describe actions that are +continuous in time, such as animations or coroutines. .. tip:: - Verbs can turn into adjectival nouns with -ing. This is not a - conjugation, so you may use them: ``the remaining movement``, - ``the missing file``, etc. + Adding -ing at the end of a verb can turn a noun into an adjective. + These -ing words are not an example of progressive form, and you may + use them: ``the remaining movement``, ``the missing file``, etc. Remove unnecessary adverbs and adjectives ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~