sosumi.ai: Apple Developer Docs for LLMs
========================================

  By John Gruber  
  https://daringfireball.net/linked/2025/08/31/sosumi-ai
  Sunday, 31 August 2025

Link: https://sosumi.ai/

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][n], to human readers, as [my original tab-indented style][tab].

[my boy]: https://daringfireball.net/projects/markdown/

[🤺]: https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks

[n]: https://daringfireball.net/linked/2025/08/31/sosumi-ai.text

[tab]: https://daringfireball.net/projects/markdown/syntax#precode




★
Tagged: AI Code Generation · Developer Documentation · LLMs · Markdown