OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

office message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: [OASIS Issue Tracker] Commented: (OFFICE-2214) Public Comment:Comments on Part 3: RNG schema for Manifest

    [ http://tools.oasis-open.org/issues/browse/OFFICE-2214?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16791#action_16791 ] 

Dennis Hamilton commented on OFFICE-2214:


I think the public comment is more than about readability.  It is about compactness, ease of comprehension, and avoidance of errors and misunderstandings.

The current  OpenDocument-manifest-schema-v1.2-cd1.rng RNG Schema file has rote use of multiple layers of reference indirection to express the schema.  Part of this involves having separate definitions for each component that is combined into a single element definition, even if there is only one place where the separate definition is combined in.   This form of heavy "goto"-like style requires that the entire schema be scanned for combinations when they could easily be placed in-line in the one place they are used.

This separation may have been valuble when the schema was presented in fragments laced throughout the specification.  It allowed having schema-carried definitions near in proximity to the relevant text.  This is no longer the case since (1) we no longer have schema fragments interleaved in the text and (2) the organization of the attribute descriptions in the current organization of the ODF 1.2 Part 3 text  is done in a way that would be maddening if also followed in the schema.

The ODF 1.2 Part 3 Manifest Schema is not very large.  It should be easy to rewrite it in a more-compact and readily-understandable form.  I suggest that we should attempt the simplification to confirm whether the improvements justify the change.  This is not an automatic precedent for Part 1, since the ODF 1.2 Part 1 main schema has definitions that are separated out for sharing and re-use in multiple parts of the schema.

Since consultation of a separate schema file (or a schema all in one place in the specification) is now required, I recommend that we give serious attention to making the schema more compact and straightforward.

> Public Comment: Comments on Part 3: RNG schema for Manifest
> -----------------------------------------------------------
>                 Key: OFFICE-2214
>                 URL: http://tools.oasis-open.org/issues/browse/OFFICE-2214
>             Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
>          Issue Type: Bug
>          Components: Schema and Datatypes
>    Affects Versions: ODF 1.2 Part 3 CD 1
>            Reporter: Robert Weir 
>            Priority: Minor
> Copied from office-comment list
> Original author: "MURATA Makoto (FAMILY Given)" <eb2m-mrt@asahi-net.or.jp> 
> Original date: 17 Nov 2009 02:31:09 -0000
> Original URL: http://lists.oasis-open.org/archives/office-comment/200911/msg00003.html

This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]