-
Notifications
You must be signed in to change notification settings - Fork 39
/
l_concept_advanced_exercise.dita
37 lines (37 loc) · 2.19 KB
/
l_concept_advanced_exercise.dita
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_advanced_exercise">
<title>Developing a technical content strategy</title>
<conbody>
<p>After reviewing the existing information products, you should have a list of content challenges
and ideas for improvement. Here are some common scenarios.</p>
<section>
<title>Reuse between technical documentation and training materials</title>
<p>The training department uses reference and task information created by the technical
documentation team, but the instructional designers copy and paste instead of linking because
the two groups use different, incompatible content creation tools. </p>
<draft-comment>Add: "If the two teams standardized on a single workflow, they could share content
seamlessly and avoid lots of tedious reworking."</draft-comment>
</section>
<section>
<title>HTML output is needed in addition to PDF</title>
<p>Your content may look like this in HTML:</p>
<codeblock><div class="p">You may produce high-value content, such as the following:
<ul class="ul">
<li class="li"><p class="p">Training materials</p></li>
<li class="li"><p class="p">White papers</p></li>
<li class="li"><p class="p">Knowledge base articles</p></li>
</ul>
</div></codeblock>
<p>The <codeph><div></codeph> contains the unordered list.</p>
</section>
<section>
<title>Technical content is outdated because of inefficient updating process</title>
<lq href="http://contentstrategy101.com/contents/developing/assessing-the-situation/analyzing-existing-information-products/" format="html" scope="external">The book production process—generating tables of contents and indexes, checking pagination,
creating change page logs, and similar tasks—takes a significant amount of time. As a result,
books are only updated twice a year. But the product is changing quarterly or even monthly, so
the technical documentation is almost always out of date. Readers are complaining about the lack
of synchronization between the product updates and the content updates.</lq>
</section>
</conbody>
</concept>