The first paragraph is written using 3 short phrases, which is correct 'per se', but doesn't read naturally in English.

E.g. "The following methods do modify the current matrix. Each method returns the current matrix the method was called on. This allows authors to chain method calls."


I suggest that we try to re-write instead using a longer phrase like:

E.g. "The following methods modify the current matrix, so that each method returns the matrix where it was invoked. The primary benefit of this is to allow content creators to chain method calls."


What you guys think?