Definition of relatinship

[Arms, Caroline]

Happy New Year!

Murata-san.
There are certainly problems with many of the Terms and Definitions.  Way back, Rex made a pass through them to try and make sure that they followed the (new?) editorial guidelines.  However, he did not use any Notes, which I believe are (a) allowed and (b) often useful, particularly to relate abstract concepts to concrete OOXML terminology.  I had been assuming we would do a complete pass through the Terms and Definitions at some point.

However, I have some concerns about your rewrite, which tries to define terms that are never used and in my view makes the collection of definitions more confusing.  I went back to the published terms and definitions in Part 2 rather than starting with the WD.  Then I focused on the same terms defined there – since they are certainly used in the text. Note that  I have assumed that “source” and “target” are words that do not need definition.  And I have assumed that the Internal/External TargetMode issue is covered in the spec.   I have changed some occurrences of “the” to “a” to address your concerns C and D.

Here is my attempt:

package relationship — A relationship whose target is a part and whose source is the package as a whole.
(Note: Package relationships are found in the package relationships part named “/_rels/.rels”.)

relationship —A connection between a source, which may be a part in the package or the package as a whole and a target, which may be a part in a package or an external resource.
(Note: A relationship is represented by a Relationship element in a relationships part.)

relationships part — A part containing an XML representation of relationships.
(Note: a relationships part has the media type "application/vnd.openxmlformats-package.relationships
+xml")

relationship type — An absolute IRI used to identify the nature of a relationship.
(Note: a relationship type is indicated in the Type attribute of a Relationship element)

source part — A part from which a connection is established by a relationship.

target part — A part referenced by the “Target” attribute of a relationship.

  I hope this helps.
  Caroline

From: eb2mmrt at gmail.com [mailto:eb2mmrt at gmail.com] On Behalf Of MURATA Makoto
Sent: Wednesday, December 23, 2015 9:29 PM
To: SC34
Subject: Definition of relatinship

Merry Christmas!

Here is my present for you.  I thought OOXML experts might like it.

I am reviewing the definition of relationships in OPC.  Let me report
some problems.

A) Circular definitions

"source part" and "target part" are defined using "relationship", but
"relationship" is defined using them.

B) Relationships and package relationships

In the definition of "relationship", the source is always a part. But
"package relationship" is defined as a special case of "relationship".

C) source is not always a part

In the case of a package relationship, the source is not a part but
rather a package.

D) target is not always a part

When the relationship mode is external, the target of a relationship
is not a part but rather any external resource.

E) Some terms are abstract, while others are XMLish

"relationship" is defined as a connection, which I call abstract.
Other terms "source part", "target part", and "package relationship"
are also abstract.  But "relationships part" is defined as an XML
representation.

Here is the definitions extracted from the current WD.

4.23
package relationship
relationship whose target is a part and whose source is the package as a whole

4.32
relationship
connection between a source part and a target part in a package

4.33
relationship type
absolute IRI for identifying a relationship

4.34
relationships part
part containing an XML representation of relationships

4.39
source part
part from which a connection is established by a relationship

4.43
target part
part to which a connection is established by a relationship

-------------------------------

I would like to propose a rewrite.  Am I too worried?

relationship part
a part of the media type "application/vnd.openxmlformats-package.relationships+xml"

source of a relationship part
a part or an entire package with which the relationship part is associated by
a file name convention.

relationship
a Relationship element in a relationship part

source of a relationship
the source of the relationship part containing the relationship

target mode of a relationship
either "Interal" or "External" as specified by the value of the
TargetMode attribute of the relationship

target of a relationship
the resource referenced by the Target attribute of the relationship
(Note: when the targe mode is internal, the target is a part)

relationship type of a relationship
the IRI value of the Type attribute of a relationship

Requirements

a relationsip part shall conform to the schema .... after MVC preprocessing

Regards,
Makoto
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.vse.cz/pipermail/sc34wg4/attachments/20151231/2a20cf14/attachment-0001.html>