It's very common that theme or plugin authors build systems that rely (or at least produce the best results) with standardized inputs. As some examples:
- A featured image that should always be 450x250 or at-least 100px-square or "a cropped headshot"
- A specifically formatted title (e.g. "'{Title}': {Subtitle}")
- A specific type of description for the excerpt (e.g. "First sentence describes the animal. The second describes its habitat.")
In the past, I've had to write documentation, but that never is convenient enough at the moment the site editor needs it. What's I'd love to see is some way to add contextual inline help in one of these ways:
- A question mark icon with tooltip (aka "helptip") after the field name
- Inline help text immediately below the field label or field input.
- Help text that somehow appears on element focus.
It would be AMAZING, if there were a series of hooks—maybe admin_tooltip_{feature}—that allowed the easy creation of helptips. There are already some hooks where you could do this, but they're unstandardized and not everywhere they could be.