ESSENCE2 — Clarity

Issues

It's just a bit hard to read.

Original Text

• A method is a composition of practices. Methods are not just descriptions for team members to read, they are dynamic, supporting their day-to-day activities. This changes the conventional definition of a method. A method is not just a description of what is expected to be done, but a description of what is actually done.

Suggestion

• A method is a composition of practices. Methods are not just descriptions for team members to read; they are dynamic and support their day-to-day activities. This changes the conventional definition of a method. A method is not just a description of what is expected to be done but a description of what is done.

Close

Generic writing guidelines are not necessarily applicable to the writing of specification documents. Nor does the seeming violation of such guidelines necessarily mean that any specific text is unclear as already written. All text in the specification was reviewed and adopted as is with specific technical interpretation. Any changes to the text for purely stylistic reasons must therefore be done with extreme care, followed by a full review, to ensure that such changes do not alter the interpretation of the text as it was adopted. This would require a considerable level of effort for a possible minor gain in presentation, which itself is likely to be subjective. Therefore, the FTF has chosen not to make such changes to the text for purely stylistic reasons.