Technical Writing Tools and Technology 2 — Questions and Answers
Question 1: What does an authoring tool's 'conditional text' feature allow a writer to do?
- Include or exclude content based on output type, audience, or product version (Correct answer)
- Spell-check automatically
- Format tables
- Insert cross-references
Correct answer: Include or exclude content based on output type, audience, or product version
Conditional text tags content so it can be included for one output (e.g., Windows) and excluded for another (e.g., Mac).
Question 2: Which version control system is most commonly used in docs-as-code workflows?
- Git (Correct answer)
- SVN only
- CVS
- Perforce
Correct answer: Git
Git is the dominant version control system for docs-as-code, enabling branching, merging, and collaborative review via pull requests.
Question 3: What is Oxygen XML Author primarily used for?
- Authoring DITA and XML-based structured technical documentation (Correct answer)
- Web design
- Video editing
- Project scheduling
Correct answer: Authoring DITA and XML-based structured technical documentation
Oxygen XML Author is a leading XML editor for creating DITA and other structured documentation with validation support.
Question 4: What is the purpose of a style linter (e.g., Vale) in a documentation pipeline?
- Automatically check writing against style guide rules (Correct answer)
- Format code
- Generate screenshots
- Translate content
Correct answer: Automatically check writing against style guide rules
Vale and similar tools enforce style guide rules automatically, flagging issues like passive voice or banned terms in CI pipelines.
Question 5: Which tool is widely used to create annotated screenshots for technical documentation?
- Snagit (Correct answer)
- InDesign
- Illustrator
- Figma
Correct answer: Snagit
Snagit is a popular screen capture tool that allows technical writers to annotate screenshots with callouts and arrows.
Question 6: What does a content management system (CMS) help technical writers manage?
- Storage, organization, versioning, and publishing of documentation content (Correct answer)
- Only web page design
- Email campaigns
- Software code
Correct answer: Storage, organization, versioning, and publishing of documentation content
A CMS centralizes content creation, versioning, workflow, and publication, making large documentation sets manageable.
Technical Writing Tools and Technology 2
What does an authoring tool's 'conditional text' feature allow a writer to do?