Posts
All the articles I've posted.
Generating page summaries with HuggingFace summarization models
Posted on:December 6, 2023 at 07:40 PMCan I use one of the summarization models published on HuggingFace to locally generate summaries for each page of my Sphinx site? The answer after one night of Covid-delirious experimentation appears to be a resounding "maybe"!
Evaluating the quality of my retrieval-augmented generation system
Posted on:June 16, 2023 at 11:11 AMI have a prototype of a retrieval-augmented generation search experience for the Pigweed docs. I need a way to measure whether the various changes I make are improving or reducing the quality of the system. This is how I do it.
Wrangling verbatim text in a Doxygen + Breathe + Sphinx docs system
Posted on:June 9, 2023 at 11:11 AMThe Pigweed docs (powered by Sphinx) are using Doxygen and Breathe to single-source their API reference documenation. Last night I was having trouble getting a plaintext diagram to render correctly. This is how I fixed it.
Software engineers want offline docs
Posted on:May 31, 2023 at 11:11 AMI don't have any grand ideas here. I just want to kick off a discussion within the technical writing community about the need for offline docs and how we might go about making our docs more easily consumable in offline contexts. I know that some docs sites already support this. I also know that it's not a new idea. My main question is: should we make it more ubiquitous? If so, how?
Docs sites with retrieval-augmented generation features
Posted on:April 30, 2023 at 11:11 AMThis post is an evergreen list of docs sites with RAG features. I will update the post as I discover new ones.
Fine-tuning an LLM into a style guide editor
Posted on:April 29, 2023 at 11:11 AMStyle guides usually have far more rules than I can possibly remember all at once while editing a doc. Can I fine-tune an large language model (LLM) to automate the process of editing a doc for style guide rules?
Response to Tom's "10 principles for writing for AI"
Posted on:April 21, 2023 at 11:11 AMThis post continues the discussion on how docs strategy might need to change in order to take full advantage of generative AI.
Positioning your docs to play nicely with generative AI
Posted on:April 18, 2023 at 11:11 AMEarly ideas about how to author docs that work well with generative AI.
The role of web service API reference documentation in ChatGPT Plugins
Posted on:April 5, 2023 at 11:11 AMChatGPT Plugins enable ChatGPT to access real-time information. Web service API reference documentation plays a big and important role in the ChatGPT Plugin architecture. You can't force ChatGPT to use your plugin. You can only persuade ChatGPT to do so by documenting your API effectively.
The curious case of the missing link text automation feature
Posted on:March 30, 2023 at 11:11 AMSphinx's approach to link text improves docs maintainability and reduces toil. Yet, curiously, this feature is absent from most other docs site systems.
Initial thoughts about the potential impact of generative AI on technical writing
Posted on:March 24, 2023 at 11:11 AMA lot of people are talking about how generative AI is a gamechanger for documentation. This post summarizes what's going on.