The Oxygen XML Positron Assistant lets you use AI tools inside Oxygen XML to help with a variety of writing tasks, such as writing short description elements, correcting grammar, improving readability, adding index terms, and more. Positron hooks into an AI provider (currently ChatGPT 3.5) to pass your topic content to the AI with a specific instruction. It then returns the content and allows you to preview the diff, seeing what has changed and inserting the modified text in place. By integrating directly with your project, Positron helps you use AI when and where you need it, without switching contexts or resorting to external tools.
One of the classic stories that is told in our profession is how and why we got into technical writing. The story is usually one of unintended directions and decisions, in which someone initially intends to pursue one career, makes a series of adjusting decisions and course corrections, and finally ends up writing docs as a tech writer. Because so few people actually set out to become tech writers, the story is usually interesting to listen to...
I made some updates to the PDF options for my API doc course. Previously, I had one massive PDF that was 900+ pages. I split that long PDF into chapter PDFs instead, making each chapter PDF about 50-75 pages in length. I also put the chapter PDFs into the Buy Me a Coffee Shop digital downloads feature and priced them at $3 each or $20 for all.
I routinely run into tech writers in Seattle who have never heard about Write the Docs Seattle, which is a local meetup for the larger Write the Docs (WTD) organization. The WTD Seattle meetup is publicized through meetup.com and includes an organizing host who facilitates welcoming and discussion among the members. Currently, WTD Seattle is holding monthly coffee chats referred to as “Casual Caffeine Hour” events. These events are held in th...
In this post, I explore the challenges of transforming a blog series into a book. The process proved to be more complex than I thought, and I had to deal with inconsistencies around tense (present vs past tense), time management, momentum, and more. Trying to read through 70,000 words to see if it had the shape and arc of a book was no small feat, and is one I'm still wrestling with.
I've been a bit quiet on my blog lately because I've been focusing on some technical upgrades. They probably aren't that noticeable, but I recently merged the blog and API doc site into the same code base. Working from a single code base will make site enhancements much easier in the future.
Doctave is a new docs-as-code SaaS documentation platform built on Rust. In this post, I ask co-founder Niklas Begley more questions about the origin behind the platform, differentiating features, approaches to common problems, and more. If you're looking for a docs-as-code platform that will allow you to get productive with documentation authoring quickly, Doctave looks to be a promising solution.
I recently tried a new approach to my newsletter: summarizing news articles. The new approach resulted in good engagement but left me feeling empty. News exploits our psychological vulnerabilities, including our novelty bias, negativity bias, and fear of missing out. We should be mindful of our news consumption and balance it with other more self-directed activities.
Here are tech comm news and links for May 19, 2023.
Here are a few quick tips for finding academic research related to tech comm.
Rob Walker's The Art of Noticing can help you see the familiar environment around you in a new light.
Tools like ChatGPT are diminishing reliance on essay cheating services. This doesn't mean fewer students are cheating, though. In fact, cheating is likely more rampant with AI tools, and more students are losing the patience to write.
In this Q&A focused on switching from DITA to docs-as-code tools, specifically Docusaurus, technical writer Mikes Howes shares the considerations, deliberations, and tradeoffs when choosing and implementing a new authoring tool.
The following are tech comm links, articles, and thoughts for May 11, 2023.
The following are tech comm links, articles, and thoughts for May 9, 2023.
