By John Gruber
What’s more powerful: pen,
pencil, or AI magic wand?
Find out at TextJam.com
Sosumi.ai:
Ever notice Claude struggling to write Swift code? It might not be their fault!
Apple Developer docs are locked behind JavaScript, making them invisible to most LLMs. If they try to fetch it, all they see is “This page requires JavaScript. Please turn on JavaScript in your browser and refresh the page to view its content.”
This service translates Apple Developer documentation pages into AI-friendly Markdown.
Perfect little audio easter egg on the page. Beautiful Markdown output too. Look at my boy, all grown up, teaching robots how to program.
I do regret, though, that I didn’t define or influence the fenced style for code blocks. If I had, instead of this:
```swift
// An array of 'Int' elements
let oddNumbers = [1, 3, 5, 7, 9, 11, 13, 15]
```
You could do this, which looks so much better:
``` Swift:
// An array of 'Int' elements
let oddNumbers = [1, 3, 5, 7, 9, 11, 13, 15]
```
Those all-lowercase language identifiers, with no preceding space, just look a little lazy. I realize why GitHub’s ```
-fenced code blocks took off (they’re the only code block style most Markdown users know, I suspect), but they don’t look nearly as nice, to human readers, as my original tab-indented style.
★ Sunday, 31 August 2025