-
Type: Improvement
-
Status: Closed
-
Priority: Trivial
-
Resolution: Fixed
-
Affects Version/s: V4.0_WD01
-
Fix Version/s: V4.0_WD01
-
Component/s: ATOM Format
-
Labels:None
-
Proposal:
-
Resolution:
In the current reviion of the workproduct [odata-atom-format-v1.0-wd01-2012-11-27.doc](https://www.oasis-open.org/committees/download.php/47557/odata-atom-format-v1.0-wd01-2012-11-27.doc) the abstract reads:
"""
The OData protocol is comprised of a set of specifications for representing and interacting with structured content. This document describes the OData Atom Format returned from an OData Service when requesting the application/atom+xml mime type.
"""
with the terms 'application/atom+xml' formated in a different way (presumably to show this is a special token). The introduction (section 1 on page 6 of 37 in PDF-A4-Output) starts with (identical text):
"""
The OData protocol is comprised of a set of specifications for representing and interacting with structured content. This document describes the OData Atom Format returned from an OData Service when requesting the application/atom+xml mime type.
"""
I think we should avoid this. An abstract condenses the content of the document regardless of reader knowledge or presentation sequence. It has a passive function saying: "this is what i am". The reader is active and may decide to continue or not.
The introduction is reader oriented and adapts for the presentation sequence in the remaining document. It tells what the author expects as prerequisites from the reader, may offer a guiding line and in summary helps the imagined reader to a good start into the subject i.e. here the rest of the document.
Also I discourage usage of special formating in abstracts, (as with the mime type token in this case).