By Tom Johnson / @tomjohnson
idratherbewriting.com
Slides: fizzled_trends
What is it? | |
Why I adopted it | |
Why I abandoned it | |
Current status |
Use inductive reasoning to discover principles related to trends that will allow us to assess the viability of current trends
What is it? | Single-source content, generate complete web output |
Why I adopted it | Produce both print and web content from the same source |
Why I abandoned it | Needed collaborative platform for community contributions |
Current status | Important because both PDF and web output still needed |
What is it? | Allow anyone to edit and contribute. Distributes work to the crowd |
Why I adopted it | Worked at a company with lots of willing volunteers |
Why I abandoned it | Crowdsourcing doesn't work for docs |
Current status | Wikis popular internally. Externally, evolved into GitHub pull requests |
What is it? | Dynamically narrow down content based on filters |
Why I adopted it | Abundance of content online made findability critical |
Why I abandoned it | Facets not a clear fit for information products. Weak tool support |
Current status | Not common in docs. XML and web drifted apart |
What is it? | Short videos that show how to do a specific task |
Why I adopted it | Popularity of YouTube showed multimedia as a learning preference |
Why I abandoned it | Videos not well suited for developer docs, code how-to |
Current status | Still popular but not common TW output due to high production costs |
What is it? | Short 1-2 page guides that get users going on key tasks |
Why I adopted it | Easy way to make text-based information appealing |
Why I abandoned it | Getting started tutorials more common in dev docs |
Current status | Common for hardware products. Often the only thing users read |
What is it? | Started out with blogging but evolved into a multipurpose platform |
Why I adopted it | Easy way to create & manage websites. Lots of plugins & themes |
Why I abandoned it | LAMP stack not supported in the enterprise. Cumbersome to update |
Current status | Still popular for websites, but not for docs |
What is it? | XML schema designed for documentation. Elements with rules |
Why I adopted it | Grew tired of using tools not designed for TWs |
Why I abandoned it | Markdown more common for developer tooling and workflows |
Current status | Used in large enterprises because most CCMS's require XML structure |
What is it? | Strategic analysis and planning about content. All the meta work around writing |
Why I adopted it | Recognized the strategy work behind writing docs. Writing is commodity |
Why I abandoned it | Strategy not as important as tactics. Success formula not a huge mystery |
Current status | Still popular. Lots of variation in what content strategists actually do |
What is it? | Project methodology for agile. Short iterations, continuous integration |
Why I adopted it | Made it easier to work with Scrum-based engineering teams |
Why I abandoned it | Not a good fit for partially allocated resources |
Current status | Common project methodology but has many variants and adaptations |
What is it? | Documentation can be leveraged as a full-fledged marketing asset |
Why I adopted it | Thought it would be good fit for tech writer who also blogs |
Why I abandoned it | No openness about issues. Just release notes and tech tips |
Current status | Intersection between domains should focus on content re-use |
What is it? | A style of writing that encourages standalone, modular articles |
Why I adopted it | Obvious that web landscape would be dominant space for information |
Why I didn't abandon it | Developers prefer lengthy pages -- they preserve context, allow Ctrl+F |
Current status | Web patterns becoming second nature, including doc styles |
What is it? | Documentation proliferates with rise of web APIs |
Why I adopted it | Higher demand in job market, and REST APIs more accessible |
Why I didn't abandon it | Working on a code level is interesting and challenging |
Current status | Will continue to be popular because APIs dominate the web |
What is it? | Way to manage text files, allow distributed teams to collaborate. |
Why I adopted it | Follow same workflows as software dev because docs also live in code |
Why I abandoned it | Lack of community contributions. Complicated pre-release workflows |
Current status | Used mostly with docs-as-code tools and dev docs |
What is it? | Using more developer-centric tools and workflows for creating docs |
Why I adopted it | Allow developer SMEs to collaborate and participate in docs |
Why I didn't abandon it | Flexible and customizable, more enjoyable working in raw text |
Current status | Common in dev docs, though more robust tooling requires tools teams |
What is it? | Discarding the workplace in favor of working remotely using virtual tools |
Why I adopted it | Mandated with pandemic, suits work of tech comm well |
Why I abandoned it | Hybrid model replaces WFH, social isolation lowers morale, community loss |
Current status | World events could propel us into virtual, metaverse-like model |
Experiment: Assess whether fully remote work is here to stay or whether it's a temporary reconfiguration due to a time-bound event.
Application: The post-pandemic world is a new context where previous models might no longer apply. Previously, fully remote workers were often contractors hired through outsourcing, and outsourcing didn't make local tech writers extinct. But in the context of a post-pandemic world, outsourcing might be more common because everyone would already be remote.
Application: Tech writing professions are here to stay because no matter the tooling, writing is a lot of work that non-writers just won't naturally start doing on their own. But the connection to remote work here isn't clear.
Application: Though not a tool, remote work offers much more flexibility and customization of schedules, location, family arrangements, and more. You can adapt your schedule to almost anything, attend virtual meetings, video conference from anywhere, interact with tools asynchronously, etc. The flexibility of the fully remote model suggests that it will win over models with more constraints.
Application: Although many tech companies now offer permanent remote, it seems that most companies are offering hybrid models. Hybrid models would reduce the chances of a disruptive, globally distributed workforce and would keep things relatively the same. However, if permanent remote companies prove more competitive, they could accelerate the shift to remote work.
Application: Look to engineers and web-centric tech companies as trendsetters. Many engineers seem suited to remote work because coding is a task requiring a lot of deep concentration and uninterrupted flow. Extended concentration is even more challenging to achieve given how social media has reduced our attention span dramatically. Most devs dislike meetings for the disruption and context switching. Remote work amplifies the isolation and might be a way engineers cling to possibilities for creative flow.
Application: If engineers prefer permanent remote, then tech writers (who interact mainly with engineers) should likely follow suit to match similar rhythms, workflows, tools, and preferences as engineers (at least in dev docs). Where engineers go, tech writers will follow.
It seems more likely than not that fully-remote work becomes the norm for tech companies in the future, but for the time being, most are adopting hybrid models.
Tom Johnson
— idratherbewriting.com
— @tomjohnson
— [email protected]