Open ptgott opened 2 years ago
I like the way PagerDuty's docs do this (https://support.pagerduty.com/docs/services-and-integrations):
The HTML/CSS are interesting:
<ol>
<li>Navigate to <strong>Services</strong> <i class="fa fa-arrow-right"></i> <strong>Service Directory</strong> <i class="fa fa-arrow-right"></i> select or search for your desired <strong>service</strong>.</li>
<li>Select the <strong>Settings</strong> tab and click <strong>Edit</strong> to the right of <strong>Assign and Notify</strong>.</li>
<li>Under <strong>Assign to escalation policy</strong>, search and select an <strong>escalation policy</strong>.</li>
<li>Click <strong>Save changes</strong>.</li>
</ol>
The fa-arrow-right
CSS rule looks like this:
.fa-arrow-right:before {
content: "\f061";
}
In our docs, we often need to guide a reader through a sequence of UI menu selections in a third-party product. We don't have a standard way to do this, and all available methods end up looking somewhat clunky.
Examples:
In the Desktop Access getting started guide, we use code style:
In our ADFS SSO guide, we use italicized arrows:
Are there any more elegant ways to achieve this? I think we could either: