Problem/Motivation
The UI standard page for Form elements is incomplete: https://www.drupal.org/docs/develop/user-interface-standards/contextual-...
Proposed resolution
Rewrite the page and add missing screenshots.
Check whether core modules follow this standard.
Remaining tasks
1. How-Why-Examples. Extend the text to say how form elements should be used, why, and then follow it up by a good example. Add accessibility considerations to take into account.
2. Add screenshots.
3. Add a one sentences summary that's useful on https://www.drupal.org/docs/develop/user-interface-standards
4. Add the correct link for the Drupal 8 API.
5. Check several modules whether they use the contextual links this way. Add in a comment which pages you checked.
6. If you find a module that does not follow this standard: make an issue to fix this.
Comments
Comment #2
ifrikComment #14
mgiffordThis page as last updated in 2018.
I like the suggestion about adding better docs here. How should this be updated for D10?
Comment #15
quietone commentedThis is for the Documentation project.