Bug 15566 - Phrases like "is treated as", "computes to" are unnecessarily vague
Phrases like "is treated as", "computes to" are unnecessarily vague
Status: NEW
Product: CSS
Classification: Unclassified
Component: CSS Level 2
unspecified
All Windows 3.1
: P2 normal
: ---
Assigned To: Bert Bos
public-css-bugzilla
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2012-01-15 10:14 UTC by Anton P
Modified: 2012-12-04 00:51 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Anton P 2012-01-15 10:14:36 UTC
Reported by Peter Moulder

10.5 ('height'):
  # <percentage>
  # [...] computes to [...]

10.7 ('min-height', 'max-height'):
  # <percentage>
  # [...] is treated as [...]

Such phrases should be replaced with more explicit ones, such as "The computed value is", etc.

Conversation begins:
Bug description:
http://lists.w3.org/Archives/Public/www-style/2011Sep/0008.html

Bug description:
http://lists.w3.org/Archives/Public/www-style/2011Sep/0011.html
Comment 1 Anton P 2012-02-04 16:27:01 UTC
Another example, reported by Anton Prowse

The last sentence of 9.3.1 (Choosing a positioning scheme: 'position' property) is:

   # User agents may treat position as 'static' on the root element.

What does this actually mean?  That the used value is 'static'?

(Also, this information could ideally be repeated in 9.7 (Relationships 
between 'display', 'position', and 'float').)

See: http://lists.w3.org/Archives/Public/www-style/2011Jan/0087.html (Issue 5)
Comment 2 Tab Atkins Jr. 2012-07-12 22:14:07 UTC
"computes to" isn't vague at all. It means exactly what it says - it's defining the computed value.

If it's used in any other manner, it's an error and should be reported as such.