task.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
<!-- This file can be edited downstream. -->
<!DOCTYPE topic
[
  <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
    %entities;
]>
<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
<!-- point back to this document with a similar comment added to your legacy doc piece -->
<!-- refer to README.md for file and id naming conventions -->
<!-- metadata is dealt with on the assembly level -->
<topic xml:id="task-example"
 role="task" xml:lang="en"
 xmlns="http://docbook.org/ns/docbook" version="5.2"
 xmlns:its="http://www.w3.org/2005/11/its"
 xmlns:xi="http://www.w3.org/2001/XInclude"
 xmlns:xlink="http://www.w3.org/1999/xlink"
 xmlns:trans="http://docbook.org/ns/transclusion">
  <info>
    <title>Executing task X (with tool Y)</title><!-- can be changed via merge
in the assembly -->
    <!-- add author's e-mail -->
    <meta name="maintainer" content="" its:translate="no"/>
    <abstract><!-- can be changed via merge in the assembly -->
      <para>
       Introductory text
      </para>
    </abstract>
  </info>
  <section xml:id="task-example-introduction">
    <title>Introduction</title>
    <para>
      A paragraph of text.
    </para>
  </section>
  <section xml:id="task-example-requirements">
    <title>Requirements</title>
    <itemizedlist>
      <listitem>
        <para>
          An
        </para>
      </listitem>
      <listitem>
        <para>
          Unordered
        </para>
      </listitem>
      <listitem>
        <para>
          List
        </para>
      </listitem>
    </itemizedlist>
    <para>
      A paragraph of text.
    </para>
  </section>
  <section xml:id="task-example-executing">
    <title>Executing the task</title>
    <para>
      A paragraph of text.
    </para>
    <procedure>
      <para>
        A short introduction to the procedure.
      </para>
      <step>
        <para>
          A step.
        </para>
      </step>
      <step>
        <para>
          A second step.
        </para>
      </step>
      <step>
        <para>
          A third step.
        </para>
      </step>
    </procedure>
  </section>
  <section xml:id="task-example-summary">
    <title>Summary</title>
    <para>
      A paragraph of text, summing up the result of the task.
    </para>
  </section>
  <section xml:id="task-example-troubleshooting">
    <title>Troubleshooting</title>
    <para>
      Add some troubleshooting information, if applicable.
    </para>
  </section>
</topic>