W3C

 

On this page

How to raise issues in the i18n Tracker

The i18n WG uses tracker to track comments raised against the specs of other WGs. This page outlines how WG members raise those issues. It is verbose to help beginners. Practised hands can just follow the highlighted text for reminders.

Members of the i18n Interest Group are encouraged to submit comments to www-international@w3.org. The i18n WG will then convert those comments to tracker issues as appropriate. If you are submitting comments to www-international, please submit one comment per email - otherwise the threads are likely to get hopelessly tangled.

Start here!

You may encounter a new issue while reviewing a spec or come across an issue already raised by someone else in an email thread or bugzilla and feel that the i18n WG should follow that thread. In either case, follow the steps below and click on the links to see detailed instructions.

  1. Is there a tracker product at http://www.w3.org/International/track/products for the document in question?
    If yes, go to step 2.
    Otherwise, create a product, then go to step 2.
  2. Create an issue.
  3. Once the i18n WG has reviewed the comments, notify the relevant Working Group.
  4. Monitor the email/bugzilla thread and contribute to the discussion.
  5. When the issue has been addressed, close the issue and inform the relevant WG that you have done so.

i18n WG shepherds are assigned to products to facilitate work on the issues. They bring issues to the i18n WG attention if action is needed to move them forward or close them. In particular, shepherds should regularly check that relevant WGs have been notified about issues raised, but you should check that the i18n WG reviews your new issues.

Create a product

  1. Click on the Add a new product link at the bottom of the list of products.

  2. Choose a name for the product that represents the document concisely (the short form of a document name used in it's URI is usually a good idea). Type the name in the Name field

  3. IMPORTANT! Always leave the mailing list selection set to default (public-i18n-core@w3.org).

Create an issue

  1. Go to http://www.w3.org/International/track/ and click on 'Create' under 'Issues' at the top right of the page.

  2. Choose the product. Fill in Raised by. Do NOT put anything in the Nickname field.

If this is an issue you are raising (eg. via a review), follow these steps (see an example):

  1. Write a short, succinct title and add " " to the end (to signify that this issue is pending review by the WG).

  2. Always start the description with information about the location of the text your comment refers to.  Do this by listing the section number and name, followed by a URI.  For example:

    6.2.1 Extended Metadata Block
    http://www.w3.org/TR/2010/WD-WOFF-20101116/#Metadata

    Try to always use dated versions of the spec and point to the section in that dated version. This makes it easier to see the original text later. Adding the URI takes a few moments longer, but it saves lots of time later for you and others reading the issue.

  3. Write your comment, in as succinct and well-organised a way as possible.  It is usually helpful to quote the text you are commenting on at the beginning of your comment. For example,

    "The text elements MAY be given a lang attribute."
    We feel that you should use xml:lang for this.

Otherwise (eg. this is a thread you have noticed and want the WG to track), follow these steps (see an example):

  1. Use the subject of the email thread or the bugzilla/github issue as the title and add "" to the end (to signify that this issue is being tracked, rather than raised against a WG spec).

  2. Always start the description with a link to the location of the thread. This is the first email in the email thread, if an email discussion, or to the bugzilla bug or github issue page if that's where the discussion is. For an email discussion, use the thread flattener with the email subject as a parameter, eg.

    THREAD: http://www.w3.org/Mail/flatten/index?subject=writing-mode%3A+sideways-left&list=www-style


Notify the relevant WG

If the relevant WG uses bugzilla/github (see an example):

  1. Create a bug/issue. Add www-international to the cc list for bugzilla bugs. For github, add an i18n tag, if there is one.

  2. IMPORTANT! Start the bugzilla/issue summary field with "i18n-" and add the title of the tracker comment - leading to a summary such as "i18n-ISSUE-72: BOM as preferred encoding declaration". This is important, because it means that the tracker will track the emails that are sent to public-i18n-core, and it will not confuse this issue with issues of the other WG.

  3. Copy over the information in the tracker issue description to the bugzilla/github description, incorporating any changes that arise out of discussions with the i18n WG.

  4. Edit the issue in the tracker. Add a link to the bugzilla/github page at the top of the description, such as:

    THREAD: https://www.w3.org/Bugs/Public/show_bug.cgi?id=28267

    Also remove the ⓟ from the title of the issue, since this is no longer pending review.

If the relevant WG uses email for comments (see an example):

  1. Create an email and copy over the information in the tracker issue description to the body of the email, incorporating any changes that arise out of discussions with the i18n WG.
  2. IMPORTANT! Start the email subject field with "i18n-" and add the title of the tracker comment - leading to a summary such as "i18n-ISSUE-72: BOM as preferred encoding declaration". This is important, because it means that the tracker will track the emails that are sent to public-i18n-core, and it will not confuse this issue with issues of the other WG.

  3. Send the email to www-international@w3.org and to the WG that produced the specification. (Note that we are NOT sending to public-i18n-core.) If appropriate, the email could be sent to one of the other IG lists instead of or in addition to www-international.)

  4. Edit the issue in the tracker. Add a link to the email thread flattener at the top of the description along the lines of the following example:

    THREAD: http://www.w3.org/Mail/flatten/index?subject=i18n-ISSUE-417&list=public-webapps

    Also remove the ⓟ from the title of the issue, since this is no longer pending review.



Copyright © 2013 W3C ® (MIT, ERCIM, Keio, Beihang) Usage policies apply.
Content last changed 2015-09-23 19:43 GMT.