This is awesome and timely for me...going to give it a whirl. Thanks for building. Also, there should totally be an easter egg where clicking something somewhere plays the sound!
Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
11–20 of 74 posts
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#12"AI-readable Markdown" — can't we just say "Markdown"? I'm serious about this, why are we focussing on making things accessible to AI when they should just be machine-readable and accessible to human beings in the first place? No need to taint this by bringing AI into it.
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#13Earlier quoted context omitted.
Not yet, but I plan to open source it soon. Just gotta tidy up a little bit, you know?
Why do people always say this? It’s ok to just start coding with a public repo. Code isn’t a secret.
- Keys/tokens in the code. Yes, it’s bad practice but for a hobby/personal project it’s not the end of the world
- Not wanting to get roasted
- Open source = dealing with a lot of entitlement
And the list goes on. Putting code out into the world (publicly) often sets you up for future obligation of some kind (even if it’s just saying “no”).
None of this is a stance against open source, but I understand where people are coming from.
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#14Could you share what is your motivation behind doing whole domain and web hosting ? Personally I feel that this whole AI induced problem should even exist in the first place, but even then it is ridiculous, that you have to query some web api to solve this problem, why not just publish parsed and converted to .md set of local files and be done with it.
I agree, it'd be great if Apple provided accessible documentation in the first place. Time was, Apple published self-contained docsets that you could download and read offline.
Apple's ToS pretty explicitly forbid the kind of automation required to download everything. But even if someone did that, it'd only be a snapshot in time. And a lot can can change between OS releases.
As for the hosted web app, I wanted to provide this as a public service. I plan to open source it, so anyone can self-host instead, if they're inclined.
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#15Earlier quoted context omitted.
Not yet, but I plan to open source it soon. Just gotta tidy up a little bit, you know?
Why do people always say this? It’s ok to just start coding with a public repo. Code isn’t a secret.
I think it's because, in the world of programming, people are incredibly critical. Just try putting absolutely anything out there, and you'll get certain types of people picking it apart.
I remember an early experience in my working career, when someone was sharing their sample code with a group, to demonstrate a particular concept. And one of those present picked them up on their use of magic numbers, as if that was at all relevant in the context.
I don't blame anyone for being wary of showing their work in progress. Painters often don't like their subjects trying to take a sneek peak at their work in progress, as another example.
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#16"AI-readable Markdown" — can't we just say "Markdown"? I'm serious about this, why are we focussing on making things accessible to AI when they should just be machine-readable and accessible to human beings in the first place? No need to taint this by bringing AI into it.
> why are we focussing on making things accessible to AI
Because that’s the authors actual goal? To take a web page that looks fine to human eyes but is unintuitively not accessible to AI. That’s genuinely useful and valuable.
Sure it’s no different than converting it to markdown for human eyes. But it’s important to be clear about not just WHAT but also WHY.
C’mon now. This isn’t controversial or even bad.
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#17Very interesting. You have any before and after examples? Curious how it handles some of the concurrency stuff. Actors, async/await etc..
Sure, here are a few more examples: - https://developer.apple.com/documentation/swift/tasklocal - https://sosumi.ai/documentation/swiftui/button - https://sosumi.ai/documentation/foundation/measurement Most of the docs about the language itself live on swift.org (e.g. https://docs.swift.org/swift-book/documentation/the-swift-pr... ). I've had pretty good luck getting Claude to write modern Swift code by saying things…
Are you making use of the new markdown files Apple started shipping inside Xcode? They’re probably copyrighted though
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#18I don't even bother trying to render docc catalogs into JS. It's a royal pain that breaks easily.
If GitHub could support .docc files, that would be great. Otherwise, I still use Jazzy Docs.
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#19> "Ever notice Claude struggling to write Swift code?"
Yes, that is why I quit using Claude and swapped to ChatGPT about a year ago. I've had substantially less issues with GPT.
Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
#20Just saying, sites like these are also pretty great for accessibility, screen reader users in particular.
I think this one would be slightly better if it rendered that Markdown as simple HTML if accessed through a real browser, but I can imagine even this version being pretty useful.
I think it could also make the "Small web" crowd pretty happy too.