Hi windrag, Thank you for pointing out that the example popover entries given in the “Inputting clefs” task don’t have the addition “for a X clef” - I usually do this for the inputting notations tasks, so I’m not sure why that’s missing here. I’ll get that added and it’ll be included when I publish the 3.5 manual.
I’m glad that in general the manual is useful to you! In all Steinberg manuals, information is segmented according to its type and purpose, both for consistency (certain types of information is always presented in a similar way) and to be easier/better for us authors to maintain accuracy across the entire document.
For inputting notations, there are tasks (which describe the steps you need to take in order to get to the end) and there are reference documents (which for Dorico, generally means tables of popover entries or overviews of dialogs). The reference page for the clefs and octave lines popover is linked at the bottom of the task, where the different clefs are listed with their associated popover entries. As Ben said, there is also a separate document available that just contains all the possible entries for all the popovers in Dorico. That document has been updated for 3.5.
I appreciate that having all the possible popover entries included alongside the steps might be welcome as a way of having all the information on one page, but when the popover lists get long (or in the case of e.g. the playing techniques popover, need to accommodate multiple different types of notations and require multiple separate tables), the page would get unwieldy and less helpful. I will make a note though to consider some sort of short sentence along the lines of “more popover entries are available”.
