Creating an Issues and Solutions Article Template

We will build the Issues and Solutions article using the same macros we used to build a How-to article, namely the list-datalist-optiontext-data macros.

Let's start with a table for some quick details on the affected system and the title of the issue.

Create the dropdown menu for systems like this:

Next, you can use the Reporting add-on to report on the title of the page, which in this case is the title of the issue (Optional).

Finally, some text-area blocks for symptomsdiagnosis and solution fields:

Finally, learn how you can a create a new article with this template in this tutorial.

Issues and Solutions article template
<table class="relative-table wrapped">
  <colgroup>
    <col style="width: 110.0px;"/>
    <col style="width: 612.0px;"/>
  </colgroup>
  <tbody>
    <tr>
      <th colspan="1">System</th>
      <td colspan="1">
        <div class="content-wrapper">
          <p>
            <ac:structured-macro ac:macro-id="96fc31e2-9a23-4a02-92c3-626455068702" ac:name="list-data" ac:schema-version="1">
              <ac:parameter ac:name="name">System</ac:parameter>
              <ac:parameter ac:name="separator">newline</ac:parameter>
              <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
              <ac:parameter ac:name="blankText">Not applicable</ac:parameter>
              <ac:rich-text-body>
                <ac:structured-macro ac:macro-id="9079fb29-67a9-428b-99bf-b95e03103489" ac:name="list-option" ac:schema-version="1">
                  <ac:parameter ac:name="label">Confluence</ac:parameter>
                  <ac:parameter ac:name="value">Confluence</ac:parameter>
                  <ac:rich-text-body>
                    <p>Confluence </p>
                  </ac:rich-text-body>
                </ac:structured-macro>
                <ac:structured-macro ac:macro-id="73bbf4ea-c009-4efe-909c-b7134716e33e" ac:name="list-option" ac:schema-version="1">
                  <ac:parameter ac:name="label">HipChat</ac:parameter>
                  <ac:parameter ac:name="value">HipChat</ac:parameter>
                  <ac:rich-text-body>
                    <p>HipChat </p>
                  </ac:rich-text-body>
                </ac:structured-macro>
                <ac:structured-macro ac:macro-id="31f5fc18-47f8-495f-b495-02e5136c6bc8" ac:name="list-option" ac:schema-version="1">
                  <ac:parameter ac:name="label">JIRA</ac:parameter>
                  <ac:parameter ac:name="value">JIRA</ac:parameter>
                  <ac:rich-text-body>
                    <p>JIRA </p>
                  </ac:rich-text-body>
                </ac:structured-macro>
              </ac:rich-text-body>
            </ac:structured-macro>
          </p>
        </div>
      </td>
    </tr>
    <tr>
      <th>Title</th>
      <td>
        <div class="content-wrapper">
          <p>
            <ac:structured-macro ac:macro-id="829fb338-eade-49a5-bf99-5e0a6cc66d35" ac:name="report-info" ac:schema-version="1">
              <ac:parameter ac:name="">content:title</ac:parameter>
            </ac:structured-macro>
          </p>
        </div>
      </td>
    </tr>
  </tbody>
</table>
<h2>Symptoms:</h2>
<p>
  <ac:structured-macro ac:macro-id="6e79b844-871a-4e66-8138-5b0374b5221f" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Issue symptoms</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro> </p>
<h2>Diagnosis:</h2>
<p>
  <ac:structured-macro ac:macro-id="ddb3236e-9cc7-4f49-ad92-938cb29f379e" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Issue diagnosis</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro>
</p>
<h2>Solution:</h2>
<p>
  <ac:structured-macro ac:macro-id="9d27512d-51ce-406f-89d8-2ab5cecb4c20" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Issue resolution</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro>
</p>
Pro Tip

When creating a field with predefined options, choose select for drop-down menus, check for checklist, or autocomplete for input field with live search.