[OASIS Issue Tracker] (ENERGYINTEROP-708) Editorial - Consistent Abbreviations and Casing

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

     [ https://issues.oasis-open.org/browse/ENERGYINTEROP-708?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Toby Considine updated ENERGYINTEROP-708:
-----------------------------------------
    Proposal: 
All references to Energy Interoperation have been replaced by EI except for
* in the Preface (page 1) prior to EI definition in Section 1
* in the references where a specific document (with title) is referenced

Product Instrument, and Transaction are referenced loosely in the introductory material, for narrative reasons, and then defined normatively in section 2.1.3, All instances before 2.1.3 are lower case, and all instances after 2.1.3 are upper-cased, with a language review to make sure the normative definition is being used.
All uses of product have been reviewed.
When Product refers back to EMIX it remains un-capitalized because there was not a normative definition in EMIX
Transaction is now capitalized when it refers to Transaction message or Tender interaction, but now when discussing general market dynamics.

> Editorial - Consistent Abbreviations and Casing
> -----------------------------------------------
>
>                 Key: ENERGYINTEROP-708
>                 URL: https://issues.oasis-open.org/browse/ENERGYINTEROP-708
>             Project: OASIS Energy Interoperation TC
>          Issue Type: Bug
>          Components: cts
>    Affects Versions: CTSPR01
>         Environment: Donald Hammerstrom https://lists.oasis-open.org/archives/energyinterop-comment/202111/msg00008/2111DJH_CTS_Review.pdf
>            Reporter: Toby Considine
>            Assignee: Toby Considine
>            Priority: Major
>              Labels: editorial
>
> There are 30 specific recommendations in the "Specific Recommendations" section of the submitted Hammerstrom paper. I have numbered them all for traceability as I recombine them into specific issues. The original white paper/submission can be read in the URI under "environment"There are 30 specific recommendations in the "Specific Recommendations" section of the submitted Hammerstrom paper. I have numbered them all for traceability as I recombine them into specific issues. The original white paper/submission can be read in the URI under "environment"
> 5. Section 1.6: Do not jump between use of âEI,â âEnergy Interoperation,â and âEnergy Interoperation 1.0.â I presume these are all covered by acronym and reference â[EI]â.Â
> 17. Throughout: Consistent capitalization of âProductsâ, âInstrumentsâ, âTransactionsâ, etc. is needed. â Section 4.1 and throughout: Iâm finding usage of âfacetâ to be misleading and confusing. These must be properties of some object or class or references to objectsâ behaviors. Part of the problem perhaps evolves from the double meaning of âtransactionâ that is being allowed. At times it refers generally to an interaction between Parties; at other times, it refers to a specific state of that interaction after a Tender has been accepted and contracted. If this confusion were resolved, you could make clearer reference to the various properties and states that surround interactions between parties.Â
> 18. Throughout: Once defined, use â[EI]â consistently.Â



--
This message was sent by Atlassian Jira
(v8.3.3#803004)