Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Check against i18n Review Checklist #582

Closed
12 tasks done
takuki opened this issue Apr 26, 2019 · 1 comment
Closed
12 tasks done

Check against i18n Review Checklist #582

takuki opened this issue Apr 26, 2019 · 1 comment
Labels
i18n-tracker Group bringing to attention of Internationalization, or tracked by i18n but not needing response.

Comments

@takuki
Copy link
Contributor

takuki commented Apr 26, 2019

Short i18n review checklist is here

  1. If the spec (or its implementation) contains any natural language text that will be read by a human (this includes error messages or other UI text, JSON strings, etc, etc),

    The TD spec itself does not contain such text.
    However, the TD spec defines fields "support", "description" and "title" with which the authors of TD can add natural language texts that can be read by a human.
    For Language Basics, see issue #[TBD] (@mryuichi )
    For Language Values, see issue i18n checklist for "Defining language values" #595 (@ashimura )
    For Declaring language at the resource level, see issue i18n checklist for declaring language at the resource level #584 (@mmccool)
    For Handling base direction for strings, see issue i18n checklist for Handling base direction for strings #585 (@mmccool)

  2. If the spec (or its implementation) allows content authors to produce typographically appealing text, either in its own right, or in association with graphics.

    N/A (Not Applicable)
    TD authors are not expected to produce typographically appealing text.
    TD does not provide a means to do so, either.

  3. If the spec (or its implementation) allows the user to point into text, creates text fragments, concatenates text, allows the user to select or step through text (using a cursor or other methods), etc.

    N/A (Not Applicable)
    TD users are not expected to do such operations.
    TD does not provide a means to do so, either.

  4. If the spec (or its implementation) allows searching or matching of text, including syntax and identifiers

    • TD spec contains "id" field of a Thing for identifying a Thing.
    • The "id" field is defined to be of anyURI type of XSD 1.1.
    • An implementation of TD itself does not do an operation of matching identifiers.
      • However, TDs may be entered into other systems such as RDF databases, that can then be searched using SPARQL, for example.
      • TD depends on these external standards (e.g. RDF and SPARQL) to do the right thing on identifier matching.
         
  5. If the spec (or its implementation) sorts text

    N/A (Not Applicable)
    TD spec or its implementation do not involve sorting text.

  6. If the spec (or its implementation) captures user input

    N/A (Not Applicable)
    TD spec or its implementation do not involve capturing user input.

  7. If the spec (or its implementation) deals with time in any way that will be read by humans and/or crosses time zone boundaries

    TD format has data fields that contain time.
    See issue i18n checklist for Working with time #578 - i18n checklist for Working with time (@ToruKawaguchi)

  8. If the spec (or its implementation) allows any character encoding other than UTF-8.

    N/A (Not Applicable)
    UTF-8 is the only valid encoding for TD format.

  9. If the spec (or its implementation) defines markup.

    N/A (Not Applicable)
    TD spec does not define markup.

  10. If the spec (or its implementation) deals with names, addresses, time & date formats, etc

    TD spec has data fields that contains names, time & date and numbers.
    For names, see issue i18n checklist for Working with personal names #580 - i18n checklist for Working with personal names. (@chachamimm)
    For numbers, see issue i18n checklist for Working with numbers #579 - i18n checklist for Working with numbers. (@takuki)
    For time & date, see issue i18n checklist for Working with time #578 - i18n checklist for Working with time. (@ToruKawaguchi)

  11. If the spec (or its implementation) describes a format or data that is likely to need localization.

    TD describes data that is likely to need localization such as description and title, which may be used for user interfaces related to the Thing. However, in each case such strings can also be given using MultiLanguage objects (given as "descriptions" and "titles") which allow the storage and labelling of localized alternatives. The TD spec also supports single-language default values for each such string which can however be set via language negotiation from the corresponding MultiLanguage data.

    (Ensure that there’s an approach in place which allows effective storage and labelling of, and access to localised alternatives for strings, text, images, etc.
    See issue i18n check item: TD spec describes a format or data that is likely to need localization #583 (@mmccool))

  12. If the spec (or its implementation) makes any reference to or relies on any cultural norms

    N/A (Not Applicable)
    TD spec neither depends or refers to any cultural norms.

@takuki takuki changed the title Check against Short i18n review checklist Check against i18n Review Checklist Apr 30, 2019
@mkovatsc
Copy link
Contributor

mkovatsc commented May 9, 2019

The remaining unchecked item was actually a duplicate of #584
Closing.

@mkovatsc mkovatsc closed this as completed May 9, 2019
@mkovatsc mkovatsc added the i18n-tracker Group bringing to attention of Internationalization, or tracked by i18n but not needing response. label May 14, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
i18n-tracker Group bringing to attention of Internationalization, or tracked by i18n but not needing response.
Projects
None yet
Development

No branches or pull requests

3 participants