Anchor | ||||
---|---|---|---|---|
|
This style guide is an example of what customer-facing user guides should look like and how they should be structured. It includes best practices for user guides as well as instructions on how to navigate Confluence to add macros and a table of contents to your page that will function both in Confluence and Jira Service Desk Customer Portal.
Each user guide should have an Overview section, a Table of Contents, and an Instructional Section. The setup should mirror this guide. If If you are making net new documentation, we ask that you use the User Guide Template (click the Select the dots next to createthe Create button and choose USF IT User Documentation in the 'Select Space' drop down).
Info | ||||
---|---|---|---|---|
| ||||
Anchor | ||||
---|---|---|---|---|
|
Using headings
- Highlight text you want to apply the heading to
- Click Select the Paragraph drop down (see image below)
- Choose your heading (paragraph, Heading 1, Heading 3)
Info | ||
---|---|---|
| ||
|
Creating links to the Top of Page Anchor
- Type 'Back to top' at the end of each section
- Highlight the Back to top text
- Click Select the Insert Link button (see image below)
- Click Select Advanced from the menu on the left
- Type #Top
- Click Select Insert
Info | ||
---|---|---|
| ||
|
Anchor | ||||
---|---|---|---|---|
|
Writing step-by-step instructions
- Click the Select the Numbered List button (see image below)
- Write instructions
- Bold and capitalize the Name of buttons and other options that the user is instructed to click/ select
Info | ||
---|---|---|
| ||
|
Adding a tips, notes, or warnings macro
- Click on Select on the Plus Sign drop down (see image below)
- Click the Select the Other Macros option
- Type tip, note, or warnings into the search bar
- Select the macro from the results
- Type the title of the tip, warning, or note
- Click InsertSelect Insert
- Type information within the tip, warning, or note space
Editing a tips, notes, or warnings macro
- Click the Select the icon beside the title of the tip, note, or warning
- Click the Select the Edit button
- Slick the Select the Save button when done
Removing a tips, notes, or warnings macro
- Click the Select the icon beside the title of the tip, note, or warning
- Click the Select the Remove button
Info | ||
---|---|---|
| ||
|
Anchor | ||||
---|---|---|---|---|
|
Inserting pictures
- Click the Select the Insert Files button (see image below)
- Click the Select the Upload Files button
- Upload your .png or .jpg
- Click the Select the Insert buttonClick the
- Select the Border button
Info | ||
---|---|---|
| ||
|
Sizing images in Confluence
- Click the Select the image
- Do one of the following:
- Adjust the pixel width in the text box to the left
- Click on Select on one of the sizing buttons located between the text box and the original button
Info | ||
---|---|---|
| ||
|
Adding alt text to pictures
- Click on Select on the image
- Click the Select the Properties button
- Click onSelect on Titles located on the left hand of the pop up/modal
- Fill out Titles and Alt Text with a short description
- Click the Select the Save button
Info | ||
---|---|---|
| ||
|
Anchor | ||||
---|---|---|---|---|
|
Making your Table of Contents
- Place your cursor next to your first Heading 1 title
- Click on Select the Plus Sign drop down (see image below)
- Click the Select the Other Macros option
- Click on Select on the Anchor macro
- Type the name of your anchor (i.e. Topic1)
- Repeat steps 1-5 for the remainder of your Heading 1 and Heading 3 titles
- Type your Heading 1 and Heading 3 titles in the Table of Contents space
- Highlight the first title
- Click the Select the Insert Link button (see image below)
- Click Advanced Select Advanced from the menu on the left
- Type # and the name of the anchor you made for that title (ie.eg. #Topic1)
- Click Select Insert
- Repeat steps 7-12 for the remainder of your titles
Info | ||
---|---|---|
| ||
|