cxt / webp

Automatically exported from code.google.com/p/webp
0 stars 0 forks source link

Doc improvement #263

Open GoogleCodeExporter opened 8 years ago

GoogleCodeExporter commented 8 years ago
Feedback received from Joe Duarte on the discussion mailing list.
Assigning to Lou.

====================================
I have some feedback on the webp docs.

On the cwebp page: https://developers.google.com/speed/webp/docs/cwebp

1) It would be helpful if the instructions explicitly highlighted whether an 
option can be used with the lossless option, or is limited to lossy. e.g size, 
strong, etc. – I can't tell if they can be used with lossless (some options 
indicate this, which makes the options that don't more confusing.)

2) It would also be helpful if the doc was more accessible to non-developers. 
Many people won't understand what float means, or even string, or why some 
options have the word float next to them, while others have string or int. 
While many of your users are developers, many are probably not.

On the FAQ page: https://developers.google.com/speed/webp/faq

3) There's this question: "What color spaces does the webp format support?"

The answer doesn't answer the question, but instead says that "webp uses the 
color spaces supported by the VP8 bitstream" and refers the reader to the VP8 
spec. This is an annoying practice for an FAQ page. The question should simply 
be answered directly, instead of having to dig through a different spec for a 
different format.

(I think the answer is 8-bit YUV 4:2:0. If so, you could just replace the 
redirection with that answer.)

Original issue reported on code.google.com by s...@google.com on 17 Sep 2015 at 12:30