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

 


Help: OASIS Mailing Lists Help | MarkMail Help

xliff message

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


Subject: RE: [xliff] term annotation


Thanks David.

One editorial suggestion: Could we also have some text in the Conformance section that states that "Notes" are not normative?
Because I doubt many people know that.

We have this text:

[[
As not all aspects of the XLIFF specification can be expressed in terms of XML Schemas, conformant XLIFF Documents MUST also comply
with all relevant elements and attributes definitions, normative usage descriptions, and Constraints specified in this specification
document.
]]

And notes are nested in those definitions, usage descriptions, etc. It would be clearer to say for example:

[[
As not all aspects of the XLIFF specification can be expressed in terms of XML Schemas, conformant XLIFF Documents MUST also comply
with all relevant elements and attributes definitions, normative usage descriptions, and Constraints specified in this specification
document. Notes are not normative.
]]

Ideally normative and non-normative text should be in different colors (like black and blue), so everyone is clear about it. I'm not
suggesting we do this, but it would make reading so much clearer.

Cheers,
-ys


From: David Filip [mailto:davidf@davidf.org] 
Sent: Wednesday, January 8, 2014 3:11 AM
To: Yves Savourel
Cc: xliff@lists.oasis-open.org
Subject: Re: [xliff] term annotation

Thanks Yves, I agree that it should be removed from the normative description, although the description does not contain a normative
keyword.
I will remove the word external from the description and it will be visible in the next printout.

Rgds
dF



David Filip, Ph.D.
=====================
cellphone: +353-86-0222-158
mailto:davidf@davidf.org
www.davidf.org, http://www.linkedin.com/in/davidfatdavidf

On Tue, Jan 7, 2014 at 11:52 PM, Yves Savourel <ysavourel@enlaso.com> wrote:
Hi David, all,

> Yves, this is just a note and therefore informative
> and not normative.
> We do not forbid internal references other than modules,
> we just discourage them
That note echoes the modified description in the definition of ref (section 4.3.1.27, which is normative):

[[
When used in a term annotation, the URI value is referring to an external resource providing information about the term.
]]

The word "external" should be remove.

Cheers,
-ys





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