Skip to main content
Help

Current version by: Michael Rans

Title:

-Markup and Bullet Point Best Practices
+Markup and Bullets Best Practices

Text:

-'''Markup and Bullet Point Best Practices'''
+Dozuki’s dynamic bullets allow more clarity in the way images and text can interact with each other within a guide step.
-Dozuki’s dynamic bullet points allow more clarity in the way images and text can interact with each other within a guide step.
-
-Color coding the markups on the image to correlate to the bullet points in the text allows authors to tie multiple text instructions to images without causing confusion to the reader.
+Color coding the markups on the image to correlate to the bullets in the text allows authors to tie multiple text instructions to images without causing confusion to the reader.
The best practice would be to establish a company standard for color order that all authors will follow to increase standardization. As a company, Dozuki follows the ROYGBIV order of colors.
'''Examples'''
-The image below is an example of using colored bullet points to attach 3 unique pieces of text to a single image:
+The image below is an example of using colored bullets to attach 3 unique pieces of text to a single image:
[image|139643|size=medium]
-The two images below are an example of using colored bullet points to illustrate which line of instruction relates to which image inside a single guide step:
+The two images below are an example of using colored bullets to illustrate which line of instruction relates to which image inside a single guide step:
[image|139644|size=medium]
[br]
+
[image|139647|size=medium]
-'''Callout Bullet Points'''
+'''Special Bullets'''
-Colors are not the only option for bullet points in a Dozuki guide. There are also three “callout” style bullet point options:
+Colors are not the only option for bullets in a Dozuki guide. There are also three special bullet options:
[image|139648|size=medium]
These are used most effectively with an indent so that they are not mistaken for a step in the process. Here’s an example of an indented ‘note’ below:
[image|139646|size=medium]
-The ‘note’ and ‘reminder’ bullet points behave the same as colored bullet points aside from their look. The ‘Caution’ bullet, however, has a unique behavior. Any text associated with a ‘Caution’ bullet will turn red once the draft is published as seen in the example below:
+The ‘note’ and ‘reminder’ bullets behave the same as colored bullets aside from their look. The ‘Caution’ bullet, however, has a unique behavior. Any text associated with a ‘Caution’ bullet will turn red once the edit is saved as seen in the example below:
[image|139645|size=medium]
[br]
-How do you use dynamic bullet points in your own guides?
+
+How do you use dynamic bullets in your own guides?

Category:

Guide Authoring

Discussion Topic:

Yes

Status:

open

Original post by: Michael Rans

Title:

Markup and Bullet Point Best Practices

Text:

'''Markup and Bullet Point Best Practices'''

Dozuki’s dynamic bullet points allow more clarity in the way images and text can interact with each other within a guide step.

Color coding the markups on the image to correlate to the bullet points in the text allows authors to tie multiple text instructions to images without causing confusion to the reader.

The best practice would be to establish a company standard for color order that all authors will follow to increase standardization. As a company, Dozuki follows the ROYGBIV order of colors.

'''Examples'''

The image below is an example of using colored bullet points to attach 3 unique pieces of text to a single image:

[image|139643|size=medium]

The two images below are an example of using colored bullet points to illustrate which line of instruction relates to which image inside a single guide step:

[image|139644|size=medium]

[br]

[image|139647|size=medium]

'''Callout Bullet Points'''

Colors are not the only option for bullet points in a Dozuki guide. There are also three “callout” style bullet point options:

[image|139648|size=medium]

These are used most effectively with an indent so that they are not mistaken for a step in the process. Here’s an example of an indented ‘note’ below:

[image|139646|size=medium]

The ‘note’ and ‘reminder’ bullet points behave the same as colored bullet points aside from their look. The ‘Caution’ bullet, however, has a unique behavior. Any text associated with a ‘Caution’ bullet will turn red once the draft is published as seen in the example below:

[image|139645|size=medium]

[br]

How do you use dynamic bullet points in your own guides?

Category:

Guide Authoring

Discussion Topic:

Yes

Status:

open
TRUSTe