Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

sosumi.ai

Post reply on HN
Print view View original

71–74 of 74 posts

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#71

Post by _mattt »

_mattt wrote: post #45
qazxcvbnmlp wrote: post #41

Great promise; sometimes need to reference docs to build context. I looked at the examples you posted and did a quick glance. For example '''init?(exactly: Float80)''' the tool converted it to '''- [initexactly-63925](/documentation/Swift/Double/init(exactly:)-63925)''' To achieve its goal I would be worried that it dropped the verbatim function signature. Claude still figured it out, but for more obscure stuff that…

Thanks for pointing that out. That’s most likely a mistake in how I’m translating into Markdown. I’ll look into this.

Following up — I just pushed a fix for this. This latest version significantly improves how references like protocol conformances and default implementations are rendered.

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#72

Post by _mattt »

_mattt wrote: post #14
diimdeep wrote: post #7

Could 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 pr…

Update — Source is now available here: https://github.com/NSHipster/sosumi.ai

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#73

Post by _mattt »

_mattt wrote: post #8
edomyrots wrote: post #6

Do you have a public repo? Would love to see how it's working.

Not yet, but I plan to open source it soon. Just gotta tidy up a little bit, you know?

Update — Source is now available here: https://github.com/NSHipster/sosumi.ai
Post reply on HN