A manual with a set of standards and best practices for the writing, formatting and design of documents.

Wondering how to install EDT at your instance?

A simple step by step video is ready. Here at Youtube!

A style guide establishes standard style requirements to improve the message and communication across an organisation by ensuring consistency both within an article, and across multiple articles. Because practices vary, a style guide helps to set out standards to be used in areas such as writing style, page structure, formatting, certain procedures and other areas. The style guide may require certain best practices in usage, language composition and visual composition. This template has examples that you could use to start writing a documentation style guide.

How to use the Style guide template:

Step 1. Provide an overview

Write a brief overview of the style guide you're creating and describe your target audience in the Text Data macro.

Step 2. Define the goal

In short sentences, describe your goal of creating the style guide and how it may align with the purpose in the Text Data macro.

Step 3. Add notes

Include relevant notes that people should be aware of when referring to the guide.

Step 4. Define writing style

List down writing styles that are important to note in the Repeating Data macro. E.g. Using language that’s easy for everyone to understand.

Step 5. Define the formatting

Outline the formatting that should be followed in the Repeating Data macro. E.g. Capitalization, emboldening, code snippet.

Step 6. Define page structure

Set the standards of page structure to use in the Repeating Data macro.

Step 7. Define procedures

Detail out the procedures that people has to follow through in the Repeating Data macro.

Ingredients

Apps	Scaffolding Forms & Templates
Hosting platform	Server, Data Center

Expand to use this template in your instance using storage format. Our quick start video will help you get up and running fast!

You can copy and paste this code into the Confluence Source Editor:

<ac:layout>
  <ac:layout-section ac:type="two_right_sidebar">
    <ac:layout-cell>
      <h1>Overview</h1>
      <ac:structured-macro ac:macro-id="deaae2b7-0cfb-4bc5-be95-987f7617a4d4" ac:name="hidden-data" ac:schema-version="1">
        <ac:parameter ac:name="whenNotEmpty">Overview</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <span style="color: rgb(165,173,186);">
              <em>Give a brief overview of the guideline you're creating and describe your target audience in this <a href="https://docs.servicerocket.com/scaffolding/macro-reference/text-data">Text Data</a> macro.</em>
            </span>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="3ccb66df-f191-48cc-8051-e423c425e27b" ac:name="text-data" ac:schema-version="1">
        <ac:parameter ac:name="name">Overview</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <br/>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <h1>
        <span style="color: rgb(0,51,102);font-size: 24.0px;letter-spacing: -0.01em;">Goal</span>
      </h1>
      <ac:structured-macro ac:macro-id="0717d2a5-3c73-448f-aa01-6d1ee8d6e744" ac:name="hidden-data" ac:schema-version="1">
        <ac:parameter ac:name="whenNotEmpty">Goal</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <em>
              <span style="color: rgb(165,173,186);">Describe the goal of the guideline in this <a href="https://docs.servicerocket.com/scaffolding/macro-reference/text-data">Text Data</a> macro</span>
              <span style="color: rgb(165,173,186);">.</span> <br/>
            </em>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="fd21aa74-91db-44d1-bd05-296bb985a416" ac:name="text-data" ac:schema-version="1">
        <ac:parameter ac:name="name">Goal</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <br/>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <p>
        <em> <span style="color: rgb(23,43,77);"> <br/>
          </span> </em>
      </p>
    </ac:layout-cell>
    <ac:layout-cell>
      <ac:structured-macro ac:macro-id="e6130ed0-3486-4947-96a0-c2d46526ce1c" ac:name="info" ac:schema-version="1">
        <ac:parameter ac:name="title">Can't find what you need?</ac:parameter>
        <ac:rich-text-body>
          <p>Send us an e-mail at <a href="mailto:apps.support@servicerocket.com">apps.support@servicerocket.com</a> for assistance.</p>
        </ac:rich-text-body>
      </ac:structured-macro>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="single">
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="two_right_sidebar">
    <ac:layout-cell>
      <ac:structured-macro ac:macro-id="8faade0f-64c5-44ff-a8de-3db7d5c07d64" ac:name="panel" ac:schema-version="1">
        <ac:parameter ac:name="borderColor">#AED6F1</ac:parameter>
        <ac:parameter ac:name="borderWidth">1</ac:parameter>
        <ac:parameter ac:name="titleBGColor">#AED6F1</ac:parameter>
        <ac:parameter ac:name="title">Notes</ac:parameter>
        <ac:rich-text-body>
          <ac:structured-macro ac:macro-id="51d829f4-a567-4944-955a-6d104afa9460" ac:name="hidden-data" ac:schema-version="1">
            <ac:parameter ac:name="whenNotEmpty">Notes</ac:parameter>
            <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
            <ac:rich-text-body>
              <p>
                <span style="color: rgb(165,173,186);">
                  <em>Add relevant notes that writers should be aware of in this <a href="https://docs.servicerocket.com/scaffolding/macro-reference/text-data">Text Data</a> macro.</em> </span>
              </p>
            </ac:rich-text-body>
          </ac:structured-macro>
          <ac:structured-macro ac:macro-id="da0d807c-5859-4e40-8b69-b432f5b48fb1" ac:name="text-data" ac:schema-version="1">
            <ac:parameter ac:name="name">Notes</ac:parameter>
            <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
            <ac:rich-text-body>
              <p>
                <br/>
              </p>
            </ac:rich-text-body>
          </ac:structured-macro>
        </ac:rich-text-body>
      </ac:structured-macro>
    </ac:layout-cell>
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="two_right_sidebar">
    <ac:layout-cell>
      <h1 class="_2cuy _509y _2vxa" style="text-align: left;">
        <span style="color: rgb(0,51,102);">Writing Style</span>
      </h1>
      <ac:structured-macro ac:macro-id="f24acdcd-87ac-47f7-add5-b803024cf6d7" ac:name="hidden-data" ac:schema-version="1">
        <ac:parameter ac:name="whenNotEmpty">WritingStyles</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <span style="color: rgb(165,173,186);">
              <em>List writing styles that writers should follow in this <a href="https://docs.servicerocket.com/scaffolding/macro-reference/repeating-data">Repeating Data</a> macro.</em> </span>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="651ed4ca-5092-4632-9d61-462bee8af20f" ac:name="repeating-data" ac:schema-version="1">
        <ac:parameter ac:name="name">WritingStyles</ac:parameter>
        <ac:parameter ac:name="initialRows">3</ac:parameter>
        <ac:rich-text-body>
          <p>
            <br/>
          </p>
          <ul>
            <li class="auto-cursor-target">
              <ac:structured-macro ac:macro-id="4d22ff29-e188-4ed4-acc2-736558fe7a54" ac:name="text-data" ac:schema-version="1">
                <ac:parameter ac:name="name">WritingStyle</ac:parameter>
                <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
                <ac:rich-text-body>
                  <p>
                    <br/>
                  </p>
                </ac:rich-text-body>
              </ac:structured-macro>
            </li>
          </ul>
        </ac:rich-text-body>
      </ac:structured-macro>
    </ac:layout-cell>
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="single">
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="two_right_sidebar">
    <ac:layout-cell>
      <h1 class="_2cuy _509y _2vxa" style="text-align: left;">
        <span style="color: rgb(0,51,102);">Formatting</span>
      </h1>
      <ac:structured-macro ac:macro-id="01b25c29-7b6e-4d0b-8273-1daa1fa5b0f0" ac:name="hidden-data" ac:schema-version="1">
        <ac:parameter ac:name="whenNotEmpty">Formattings</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <span style="color: rgb(165,173,186);">
              <em>List formatting types that writers should follow in this <a href="https://docs.servicerocket.com/scaffolding/macro-reference/repeating-data">Repeating Data</a> macro.</em> </span>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="5c497860-d52f-4579-a9b0-17f608a451a7" ac:name="repeating-data" ac:schema-version="1">
        <ac:parameter ac:name="name">Formattings</ac:parameter>
        <ac:parameter ac:name="initialRows">3</ac:parameter>
        <ac:rich-text-body>
          <p>
            <br/>
          </p>
          <ul>
            <li class="auto-cursor-target">
              <ac:structured-macro ac:macro-id="13111271-327a-4c24-832e-a4f49710b041" ac:name="text-data" ac:schema-version="1">
                <ac:parameter ac:name="name">Formatting</ac:parameter>
                <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
                <ac:rich-text-body>
                  <p>
                    <br/>
                  </p>
                </ac:rich-text-body>
              </ac:structured-macro>
            </li>
          </ul>
        </ac:rich-text-body>
      </ac:structured-macro>
    </ac:layout-cell>
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="single">
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="two_right_sidebar">
    <ac:layout-cell>
      <h1 class="_2cuy _509y _2vxa" style="text-align: left;">
        <span style="color: rgb(0,51,102);">Page Structure</span>
      </h1>
      <ac:structured-macro ac:macro-id="83486773-61a6-4dc5-848d-dfd4e2aa9c27" ac:name="hidden-data" ac:schema-version="1">
        <ac:parameter ac:name="whenNotEmpty">PageStructures</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <span style="color: rgb(165,173,186);">
              <em>List the page structures that writers should follow in this <a href="https://docs.servicerocket.com/scaffolding/macro-reference/repeating-data">Repeating Data</a> macro.</em> </span>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="2314b9a4-26bd-4922-8b09-999445fb4280" ac:name="repeating-data" ac:schema-version="1">
        <ac:parameter ac:name="name">PageStructures</ac:parameter>
        <ac:parameter ac:name="initialRows">3</ac:parameter>
        <ac:rich-text-body>
          <p>
            <br/>
          </p>
          <ul>
            <li class="auto-cursor-target">
              <ac:structured-macro ac:macro-id="8d5937f0-1c2e-4f1d-b158-465529d58f3f" ac:name="text-data" ac:schema-version="1">
                <ac:parameter ac:name="name">PageStructure</ac:parameter>
                <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
                <ac:rich-text-body>
                  <p>
                    <br/>
                  </p>
                </ac:rich-text-body>
              </ac:structured-macro>
            </li>
          </ul>
        </ac:rich-text-body>
      </ac:structured-macro>
    </ac:layout-cell>
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="single">
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="two_right_sidebar">
    <ac:layout-cell>
      <h1 class="_2cuy _509y _2vxa" style="text-align: left;">
        <span style="color: rgb(0,51,102);">Procedures</span>
      </h1>
      <ac:structured-macro ac:macro-id="072b4af2-2282-4a33-be7c-da7d14b9237b" ac:name="hidden-data" ac:schema-version="1">
        <ac:parameter ac:name="whenNotEmpty">Procedures</ac:parameter>
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p>
            <span style="color: rgb(165,173,186);">
              <em>List the procedures that writers should follow in this <a href="https://docs.servicerocket.com/scaffolding/macro-reference/repeating-data">Repeating Data</a> macro.</em> </span>
          </p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="20f6fb6d-eda1-4536-80e3-a9e116154c1c" ac:name="repeating-data" ac:schema-version="1">
        <ac:parameter ac:name="name">Procedures</ac:parameter>
        <ac:parameter ac:name="initialRows">3</ac:parameter>
        <ac:rich-text-body>
          <p>
            <br/>
          </p>
          <ul>
            <li class="auto-cursor-target">
              <ac:structured-macro ac:macro-id="15fc5166-e43e-454b-93f0-4d7ad11326de" ac:name="text-data" ac:schema-version="1">
                <ac:parameter ac:name="name">Procedure</ac:parameter>
                <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
                <ac:rich-text-body>
                  <p>
                    <br/>
                  </p>
                </ac:rich-text-body>
              </ac:structured-macro>
            </li>
          </ul>
        </ac:rich-text-body>
      </ac:structured-macro>
    </ac:layout-cell>
    <ac:layout-cell>
      <p>
        <br/>
      </p>
    </ac:layout-cell>
  </ac:layout-section>
</ac:layout>

Wondering how to install EDT at your instance?

A simple step by step video is ready. Here at Youtube!

Style guide template

Easy Dynamic Templates

How to use the Style guide template:

Ingredients

Apps

Hosting platform

Expand to use this template in your instance using storage format. Our quick start video will help you get up and running fast!