From resistance to adoption: navigating the challenges of docs-like-code¶
Description
Many technical writers want to implement docs-like-code and must deal with organizational resistance in the form of objections.
Technical writing has its own set of challenges. What happens when you want to introduce a new docs-like-code system and workflows? If you’ve tried or considered it and encountered organizational resistance this talk is for you.
After a brief intro to docs-like-code, we’ll overcome each of the 10 most common objections to implementing docs-like-code.
- Lack of familiarity with Markdown or other document formatting languages.
- Perceived lack of features compared to traditional word processors.
- Resistance to change from established workflows and tools.
- Concerns about collaboration and version control.
- Uncertainty about the future of the technology and lack of widespread adoption.
- Difficulty integrating with other tools or systems in use within the organization.
- Difficulty in handling more complex formatting requirements.
- Challenges in managing large documents with many dependencies.
- Inability to handle multimedia content, such as images or videos.
- Lack of support for real-time collaboration and feedback.
- Conference: Write the Docs Portland
- Year: 2023
