Comments on ITS 2.0

I've only read a few sections of the spec [1] so far; here are the comments I have for them.

[1] http://www.w3.org/TR/2012/WD-its20-20121206

Norbert


Global comments:

- A number of headings are missing spaces between section number and title.

- Numerous sentences appear to be missing articles. I've noted some of them below, but some careful copy-editing seems necessary.

1 Introduction

- "NIF" should be spelled out on first use - I didn't know what it is.

1.2 Motivation for ITS

- Links for DocBook and DITA would be useful.

1.2.1 Typical Problems

- Is there any support for strings that are not translatable but localizable, such as NavajoWhite in Example 1 or images/cancel.gif in Example 2?

1.3.1.6Text Analytics

- "These types of users": Do you mean "this type of service"?

1.3.1.7Localization Workflow Managers

- concerend -> concerned

- "bitext format": what's that? (Yes, I found out. Still, I first thought this was a typo...)

1.4.1 Support for legacy HTML content

- "migrate their content to HTML": this probably should be HTML5.

2.1 Selection

- "CSS and other query languages": I guess you mean CSS selectors?

- "supported by application" -> "supported by the application"

- "http://docbook.org/ns /docbook" -> "http://docbook.org/ns/docbook"

5.7 Conversion to NIF

- This section requires a normative reference to the NIF specification, but there is none in Appendix A.

6 Using ITS Markup in HTML

- This section should clarify that by "HTML" it really means "HTML5 in HTML syntax". It's not HTML 4, because that doesn't have a translate attribute. It's also not HTML5 in XHTML syntax, because that is case sensitive and has real namespaces.

- After reading section 2.2.3 of the HTML5 spec, I'm still not quite sure whether HTML5 documents with its-* attributes are conformant HTML5 documents, or whether they have to be labeled "conforming HTML5+ITS documents". Any clear answer?

- This section requires a normative reference to the HTML5 specification, but there is none in Appendix A.

- "Name of HTML attribute" -> "The name of the HTML attribute", "the name of attribute" -> "the name of the attribute"

- "will gets" -> "will get"

7 Using ITS Markup in XHTML

- I assume this section is also meant to cover HTML5 documents in XHTML syntax. If so, this should be called out.

8.5 Directionality

- Unicode, HTML, and CSS are adding new characters/tags/attributes/properties to support isolates. Details are still being discussed, but ITS should probably reflect the outcome.

Appendix B:

- File extensions are commonly specified with leading period, i.e., ".its".

- .its is used for some other file types - don't know whether that's likely to cause problems:
http://www.fileinfo.com/extension/its

Received on Wednesday, 16 January 2013 08:41:23 UTC