Deep Singhvi

8 posts

Deep Singhvi banner
Deep Singhvi

Deep Singhvi

@DeepSinghvi

Co-founder at Fern | YAML, JSON and MDX Engineer

nyc Katılım Ağustos 2017
408 Takip Edilen95 Takipçiler
Aaron Meurer
Aaron Meurer@asmeurer·
I know this is "for LLMs", but have you considered actually reading it? Here's the text for the /generation endpoint vs. the actual docs. "// ... additional stats" is not something that should appear in documentation. The LLM will just hallucinate the rest. To be useful, the LLM needs to see the *exact, full documentation*. Your llms.txt is even less useful. I'm guessing you tried the same thing I did and used some shitty HTML to markdown converter, but didn't bother checking the outputs. (by the way, the real issue seems to be the Fern documentation generator you're using. It buries the documentation text in some minified Javascript code on the page, making it impossible for most converters to properly see it). I'm sorry to be salty here. Your core product is great. But having quality developer documentation is really important when your product is an API.
Aaron Meurer tweet mediaAaron Meurer tweet mediaAaron Meurer tweet media
English
2
0
1
54
Aaron Meurer
Aaron Meurer@asmeurer·
I love @openrouter but they have some of the worst docs out there. Just spent half an hour trying to convert a docs page into something suitable for input to an LLM.
English
2
0
0
110
Deep Singhvi
Deep Singhvi@DeepSinghvi·
@NickFisherAU It generates both the SDK and documentation, so if you change your API definition (OpenAPI spec) then both the sdks and documentation will update.
English
0
0
0
28
Nick Fisher
Nick Fisher@NickFisherAU·
@DeepSinghvi This is just generating the presentation of the documentation though, right? It’s not like if I change void foo(int bar) to int foo(int bar), it’s going to change the content of my documentation to say “foo returns an integer of 0 for failure and 1 for success”?
English
1
0
0
30
Nick Fisher
Nick Fisher@NickFisherAU·
Every company offering an SDK/API/etc as their core product - I beg you, please try something like training a custom LLM on both your code and your docs to ensure they stay consistent. It's really aggravating when the documentation is out of sync with the API.
English
1
0
0
106
Nick Fisher
Nick Fisher@NickFisherAU·
(this would actually make for a good business idea)
English
1
0
0
31
Stephan Meijer
Stephan Meijer@meijer_s·
Do you use a codegen to generate sdks from your openapi spec? The ones I see, still require a serious amount of manual labor. This must exist right?!
English
6
0
2
1.3K
Deep Singhvi retweetledi
homanp
homanp@pelaseyed·
One of the best products I've used in a while is @buildwithfern 🔥 I've been using it generate the Superagent Python SDK which is now live : github.com/homanp/superag… They have some other fancy stuff cooking for documentation as well 🥷🥷
English
0
3
14
990
Deep Singhvi
Deep Singhvi@DeepSinghvi·
@permutans @permutans Looks like you're trying to generate a Python client / Pydantic models for your OpenAPI spec? Give Fern a spin: #fern-python-sdk" target="_blank" rel="nofollow noopener">buildwithfern.com/docs/compiler/….
English
0
0
0
22
Louis Maddox
Louis Maddox@permutans·
Fun: if you use the YAML version of the official OpenAPI schema-of-schemas you get the various Operation methods as individual keys, whereas the JSON schema represents them as a single regex, and datamodel-code-generator doesn't interpret regexes so just drops paths' HTTP methods
English
1
0
0
121
Deep Singhvi retweetledi
Mykhailo Fedorov
Mykhailo Fedorov@FedorovMykhailo·
Today me and President @ZelenskyyUa hosted Alex Karp CEO @PalantirTech. Alex is the first CEO, who came to Kyiv after the start of the full-scale war. Impressive support and faith in credibility of investments: agreed on office opening and digital support of Army.
Mykhailo Fedorov tweet mediaMykhailo Fedorov tweet mediaMykhailo Fedorov tweet media
English
81
405
2.2K
0