2. ““The only irreplaceable capital an organization possesses is the
knowledge and ability of its people. The productivity of that
capital depends on how effectively people share their
competence with those who can use it.”
Andrew Carnegie. U.S. Steel. 1919.
4. 1.
“To document or not to document, that is
the question”... Advantages and facts
5. It’s an ancestral requirement
The prehistoric man left us the legacy of his perspective of the world in
the inner walls of his refuge and all the civilizations that followed him
shared part of their knowledge in order to allow following humans to
understand where we come from and visualize future objectives
6. But from a practical perspective,
we also document because:
17. Techwriting Essencial Guidelines
Style
â—‹ Use present tense.
â—‹ Use active voice.
â—‹ Use second person (you).
â—‹ Avoid 1st person (I, we, us).
â—‹ Be gender neutral.
â—‹ Use the appropriate tone.
â—‹ Write for a global audience.
Abbreviations & Capitalization
â—‹ Spell out unknown abbreviations
at the first instance.
â—‹ Don't abbreviate product names.
â—‹ Use sentence-style (lowercase)
capitalization in most instances.
Process
○ Focus on document’s goal.
â—‹ Follow schemes.
â—‹ Synthesize at maximum.
â—‹ Write clearly.
â—‹ Use short sentences.
â—‹ Avoid acronyms.
â—‹ Use images and diagrams
â—‹ Ask for validation (structure,
content, grammar, etc.).
â—‹ Add references, sources and
useful resources.