Writing good documentation often takes longer than coding and testing. Is it a good investment of time when documentation seems so little used? Is there a better way?
help
In Big Sur and Monterey, if you’ve not opened an app’s Help book, the first time you do it may appear empty, or simply not work. Here’s why and how to fix it.
A major new version of macOS bringing few big changes, but lots of opportunity for improvements and fixes.
Time to speak Klingon to your Mac. Or, rather, don’t try this at home or you could end up with mixed languages, and Help pages in something else.
macOS Help system was last revamped in High Sierra, and has worked well. Until Big Sur has problems finding Help books, and shows some in French. How Help should work.
Details of how to get different news feeds from each part of this blog, and how to find information from its over 5,000 articles.
The Mac is now in a documentation crisis. Documentation debt is leaving many Mac users floundering around in the dark.
A simple way to provide a proper Help book for your app, and separate PDF documentation without wasted effort. Uses Swift in Xcode.
How to fix custom dictionaries so that they display properly in Dark Mode. Sadly it doesn’t (yet) work for Help books too.
I realised that almost everything listed in my Downloads page was still in beta. Finishing off is important, and requires a proper Help book.