ESSENCE2 — Update "How to Read" for consistency with specification

Issues

The following text is cumbersome and awkward, uses the passive voice, and uses the past tense.

• https://issues.omg.org/browse/ESSENCE2-2 - Passive Voice
• https://issues.omg.org/browse/ESSENCE2-3 - Present Tense
• https://issues.omg.org/browse/ESSENCE2-4 - Personal Pronouns
• https://issues.omg.org/browse/ESSENCE2-5 - Streamline text

Original Text

This specification contains detailed descriptions of both the Essence Kernel and the Essence Language. You do not need a detailed knowledge of the language to be able to read and understand the kernel. Although the kernel is specified using the language it only uses a small subset of the language, and is designed to be intuitive, self-contained and accessible to those without a detailed knowledge of the language.

Some readers will be more interested in the Essence Kernel and its usage than the details of the language. If you fall into this category, it is recommended that you focus on Clause 8 Kernel Specification dipping into Clause 9 Language Specification when and where you require more information about the language elements or icons used. You may also want to look at the examples and extensions described in the annexes before looking at the details of the language itself.

Other readers will want to understand the detail of the language before looking at the Kernel or the examples. In this case it is recommended that you first read Clause 9 Language Specification before reading Clause 8 Kernel Specification and looking at the example and extensions presented in the annexes.

We expect most readers to prefer to read the Kernel Specification before diving into the Language Specification because 1) it only uses a small subset of the language, 2) it provides a good example of the expressive qualities of the language, and 3) if it cannot be understood without first reading the entire language specification it is not a good basis for the definition and sharing or your practices and methods.

Suggestion

This specification contains detailed descriptions of the Essence Kernel and the Essence Language. Detailed language knowledge is not required to read and understand the kernel. Although the kernel is specified using the language, it only uses a small subset of the language. It is designed to be intuitive, self-contained, and accessible to those without detailed language knowledge.

Some readers are more interested in the Essence Kernel and its usage than in the details of the language. For those readers, it is recommended to focus on Clause 8 Kernel Specification, dipping into Clause 9 Language Specification when and where more information about the language elements or icons is required. The examples and extensions described in the annexes may also be helpful to review before looking at the details of the language itself.

Other readers want to understand the details of the language before looking at the Kernel or the examples. In this case, it is recommended to first read Clause 9 Language Specification before reading Clause 8 Kernel Specification and looking at the examples and extensions presented in the annexes.

Most readers prefer reading the Kernel Specification before the Language Specification because:
1. iI only uses a small subset of the language
2. It provides a good example of the expressive qualities of the language
3. if it cannot be understood without first reading the entire language specification, it is not a reasonable basis for defining and sharing practices and methods.