No this time it’s not a proposal to add support for writing documentation like last time, it’s more a proposal for the users I want to make.
Doug wrote about adding documentation for HAL USE flags (and I’m glad for that because most of them were unknown to me too), and I’ve added documentation for the USE flags I found less understandable in three packages I maintain directly (pulseaudio, amarok, rbot).
What I want to ask our users is to propose which USE flag should be better explained: a maintainer might find them obvious, and then leave them undocumented as obvious. But the feature is focused on the users, which need to know what an USE flag do.
So, if you find an USE flag that is non-obvious, not documented in metadata.xml, and the package falls in PAM, Sound or Proaudio herds, feel free to open a bug to ask for the USE flag to be documented. I’ll try to do my best to keep up with the requests.