Re: Wording change around cue box positioning

On Sat, Jun 20, 2015 at 2:38 AM, Silvia Pfeiffer
<silviapfeiffer1@gmail.com> wrote:
> Hi all,
>
> As a consequence to bug
> https://www.w3.org/Bugs/Public/show_bug.cgi?id=28073 , we recently
> changed our wording for the cue settings "position" and "line".
>
> The change was made in https://github.com/w3c/webvtt/pull/197 .
>
> You can read up on it in
> http://dev.w3.org/html5/webvtt/#webvtt-cue-settings . Pay particular
> attention to the use of "line offset" instead of "line position" now.
>
> The change was made to avoid the overloaded word "position" in both directions.
>
> There is a question in the pull request about whether this change
> makes the spec more readable or no. We're looking for input from
> others, in particular WebVTT authors.

To be clear, I'm really only concerned with the consistency of the
names, their individual definitions can certainly be improved. Quoting
https://github.com/w3c/webvtt/pull/197#issuecomment-112797871

> The "line offset" is no more an offset than the "text position", both of them influence either x-position and y-position in the rendering algorithm and then either the left or top CSS properties.

In other words, I think the names of these concepts should be either
"line position" and "text position" (the original) or just "line" and
"position". (Using "offset" in both terms would be consistent, but
then the concept corresponding to VTTCue.position doesn't even have
"position" in the name.)

Philip

Received on Tuesday, 23 June 2015 08:15:50 UTC