We mark UI elements in the TAG with :guilabel:`` so that the reader can clearly see when we are referring to something in the product. However, the only way these elements differ from other text is that they have a different font. This difference can be difficult to distinguish. Our custom fonts might also not always be respected. We should consider adding some more clear styling to make it easier to see what are direct references to the UI, and what is normal descriptive text.
As an example, this is what Canonical does: https://canonical-documentation-with-sphinx-and-readthedocscom.readthedocs-hosted.com/style-guide/ So something similar for us could be: > .guilabel { > background: #eee; > font-size: 0.9em; > border-radius: 4px; > padding: 2px 6px; > margin: auto 2px; > }
