In documentation pages, if the article describes interactions with keybindings and user interface (web or graphical software), It is possible to use AsciiDoc page or site attribute to mark up a keybindings or a button.
I see some markup is not rendered correctly because page or site attribute is not added.
Issues
Various conventions are used to describe ‘actions’ in words.
- Single quotation marks: Click ‘Open’
- Bold face: Click Open
- Page attribute in source documentation: Tree - fedora-docs/quick-docs - Pagure.io
For consistency, docs writers and reviewers need to present a button, a keyboard, and keyboard bindings.
Suggestions
if the article you write or edit describes interactions with keybindings and user interface (web or graphical software), we could benefit from putting attributes onto the heading of .adoc page like below.
= Creating GPG Keys
:experimental:
What do you think?