[widgets] P&C 1.0 Last Call WD: localization comments

Hi Marcos,

I have (still) a couple of concerns about the localization section of
Widgets Packaging & Configuration Last Call WD of 20081222.

/1/ Is the following statement in [1] as it should be?

"Author requirements: Localized folders must be at the root of the widget (a
localized folder not at the root of the widget will be treated as an
arbitrary folder)."

I think it should now read:

"Localized folders must be placed inside the container for localized content
(...)".

/2/ I was looking at the localized widget example in the same section (it's
non-normative, but important nonetheless), and it seems that the left and
right sides of the example don't agree. The paths on the right are absolute
from the root, not the container.

The right side shows en-au, but that is not found on the left side. The
first bullet of the example mentions Korean, but that does not seem to be
present. Should it be Spanish instead?

Finally, it's not obvious which of the files shown (if any) is the start
file, because the content of config.xml is not shown.

/3/ This is a potentially confusing statement:

"At runtime, the widget user agent will set the (HTML or XML) base of the
start file to the localized folder (even if the start file does not reside
inside the localized folder)."

I assume in this case "the localized folder" means the one determined in
Step 6, right? This might not be obvious from the context, it requires a
trip to the text of Step 6.

/4/ Since BCP47 tags are case-insensitive, it might be good to normalise all
their occurrences to lowercase, to avoid any confusion.

/5/ Is there value in being able to have multiple config.xml documents,
instead of just one, and tagging the relevant elements with a BCP47 tag? The
example mentions "different author and license", which could be expressed in
one file. If you have a pointer to some earlier discussion that resolves
this, it's fine. Or do you think it would make the config.xml document too
bulky?

--Jere

[1] http://www.w3.org/TR/2008/WD-widgets-20081222/#content-localization

Received on Wednesday, 14 January 2009 15:29:02 UTC