Documentation - Colour Management
I'm behind the curve on some features in Premiere Pro. I decided today to catch up on the recent changes in colour management. I started with the article on display colour management. This one article gives the impression that as Adobe innovates on features, the quality of documention gets worse.
https://helpx.adobe.com/premiere-pro/using/color-management.html
Fundamental Subject Issue:
It should be noted that is article is specifically about display colour management. But throughout, it drops this specific distinction which has the possiblity of creating confusion. One example: the second section is titles "Set up color management", by which it actually means "Set up display color management".
The “Effect of color management on a project” section is actually only talking about Viewer Gamma in spite of its title. It doesn’t mention mercury transmit … is transmit affected by display colour management or not? Also it would be good to actually have a section that does discuss 'the effect of colour management on a project' (ie. what aspects of a project are affected by colour managment and how so).
Version Information
Why is the user guide outllining information for features which are only available in Beta releases? Except that as it explains, this feature is now available outside beta. Except it doesn’t tell you which version of Premiere Pro this page of information applies to. Version 23 is currently supported by Adobe. Does this page apply to version 23 of Premiere Pro?
Grammar
“Now you can also access Preferences under Lumetri Color”: “also” means in addition to something you've already reference. (It is immediately explained what the other point of access is, but "also" is poor grammar in this construction).
Poor and Inconsistent Wording
“In an 8-bit signal, the 20 lowest Rec. 709 codes are crunched into the 7 lowest sRGB codes. For 10 bit, the 78 lowest Rec. 709 code values are crushed into the 28 lowest sRGB values.”
The word “codes” here is a poor choice - the second choice of “values” is clearer. But why use two different words to refer to the same thing in this comparison. Clarity is important. Poor choices like this are throughout the text.
Conflicting & Incomplete Information
“Access Preferences settings under General preferences or under Lumetri Color settings found in Premiere Pro (Beta).”
The sentence immediately before this explains explains you don’t need to be in the beta to have settings available in Lumetri.
There are 2 different sections on viewer gamma, giving 2 different sets of information. Which section does Adobe expect users to read and accept?
"Display Color Management works for both internal and secondary computer monitors used as part of the OS desktop.” I guess this doesn’t work on Windows machines? Edit: my comment here not warranted.
Inccorrect information
The page directs users to “Check the VRAM of your GPU” and “Check if your GPU drivers are up to date” … except this doesn’t apply to Mac users, of course. But the page doesn’t explain that.
“Enabling color management makes the Rec. 709 video appear closer than a broadcast monitor.”
What is this supposed to say?
The "screen grabs” at the end are presented uncritically … I believe they are illustrations to mimic the effects of colour management. If so they should be labelled as such (not as “screen grabs”)
Other issues
There is a weird oscillation throughout this text between not enough technical detail and too much technical detail (which is poorly presented). Good technical writing presents an overview of concepts and actions so it can be understood quickly, as well as technical details which is there for those who need more detailed understanding. The entire section on Rec.709 in sRGB colour space is a disaster in this regard. (Edit: Rec.709 in sRGB could be presented as an example of the kind of transformations that are done in colour management, rather than a definitive explanation.)
But I have the sense after reading this that it is overall really incomplete - I don’t really have a sense that I clearly know how display colour management fits into the larger picture of colour management workflow and tools - how it interacts with project, clip, sequence clip, and sequence settings.
