Writing Articles

Generally articles should be kept instructional and not conversational. Try to keep articles short and to the point.

There is a 'Dise General Guide' template that can be used to help start writing an article. Found in 'Content tools>Templates'.

Things to consider:

• Most of the article should be in bullet/numbered format.
• Don't use conversational language - "We", "you", "first we do this", "this article is going to teach you", etc.
• Try and restrict the amount of images used in an article.
• Keep titles to the point.
• There's no need to repeat what's in the title - 'Create a display' article doesn't need another 'Create a display' title in the article or to say things like 'This is how to create a display'.
• Try not to use external URLs as we don't control these. For example, just instruct to 'download the latest software from the providers website'.
• Use American spelling (more international).

Start writing the article:

1. Start with a short introduction to the article. Some simple articles don't need an intro but others may need 1-2 sentences to explain the feature.
2. Use numbered lists to instruct what to do, keeping the instruction as short as possible without missing info. If the instruction is getting to long, maybe split it across multiple steps.
3. Use 'Heading 2' to split the article into sections. Heading 2 is what shows on the table of contents.
4. Split sections of the article with the line (select the 3 dots in the top bar).
5. Use other headings for sub sections (don't divide these with a line).
6. Any large images should be 500px wide (leave height as auto). Enable all style options.
7. Smaller images should be in line and centered so it sits at the end of a sentence. These images should be anywhere between 25px-150px wide depending on how it looks on the article page. Copy the magnifying icon from another article next to the small image. Enable rounded and bordered style options.
8. Use the numbered dots in the doc360 drive (My drive -> Dise -> Articles) on images that have multiple steps linked to it. Use paint or some other editing software to add the dots to the image in the correct place (dots should be 40px x 40px).
9. Change the color of hyperlinks to #2C82C9.