Do you want a no-fuss command-line tool to lint the quality of the prose in your technical documentation project, or in your technical writing projects? Do you want something that has an uncomplicated interface, yet provides rich feedback? Then come learn about proselint.
Welcome to The Blog
Are the words in your technical documentation strong, sharp, direct, and powerful? Or are they passive, weasely, and replete with clichés and adverbs? If you want to make them stronger than they are now, then come learn about write-good.
When you're reviewing generated HTML content, broken link's are the last thing you want. However, given the massive amount of documentation in modern projects, manually hunting for broken links isn't practical. So how do you deal with this problem?
When writing technical documentation, as with writing code, you need to use a range of tools to maintain a high level of quality. In this series, I'm going to introduce you to 5 tools that help you do just that. Each of them is usable from the command-line, whether manually or as part of your documentation build pipeline.
Antora is the premier technical documentation platform. However, that doesn't mean that it's a breeze to use right from the get-go. If you have just begun using it or want to get the most out of it, this post will step you through the three key concepts that you need to know about.
Anything to do with software and computers usually ends up getting tricky, time-consuming, and repetitive. As such, if you value your sanity, you'll want to regularly look for ways to automate these tasks away. One of the best ways to do that, is by using Make - a veteran automation tool.
If you need to create and maintain technical writing, there are a large number of solutions that will give you a lot of what you want. However, which one is the best? Today, I'll show you which one I believe is the best choice.
I've been a proud VIM user for years — dating back as far as 1999 — but especially so, since I pushed myself to learn it properly a few short years ago. However, I wonder if I've become too wedded to it. And I'm keen to find out if you are too.
Earlier today, I upgraded my installation of Google Chrome from version 68 to version 69. While not a major upgrade, there's a key security update that I want to draw your attention to. Here's a quick look at it.
Last Wednesday, I was interviewed on Radio Sputnik (based out of Moscow) about a recent article on the Guardian about Google recording your location history — even when you tell it not to. This was my first experience as a subject matter expert. So I wanted to share the experience with you.
When you’re testing web applications, sometimes you want to automatically change some part (or parts) of the request, the response, or both to know how the application will react. In this post, I’ll show you how to do that automatically using Burp Suite's Match and Replace rules.
The tech sector, if you know what you're doing, is easier than most fields to get started in. However, you do have to know what you're doing. In this post, I'm going to step through a series of ways to get started, in case you're not sure.