Bug 15566 - Phrases like "is treated as", "computes to" are unnecessarily vague
Summary: Phrases like "is treated as", "computes to" are unnecessarily vague
Status: NEW
Alias: None
Product: CSS
Classification: Unclassified
Component: CSS Level 2 (show other bugs)
Version: unspecified
Hardware: All Windows 3.1
: P2 normal
Target Milestone: ---
Assignee: Bert Bos
QA Contact: public-css-bugzilla
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
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.