ibuildinpublic
Log inStart free
ibuildinpublic
Log inStart free
BuilderPosts1
·Lvl 2·Explorer·Nov 16

Developer’s Eye is live. It’s an open-source search engine for developer docs and code examples. I built the crawler, indexer, and ranking system, and the hardest question so far has been a surprisingly ordinary one: when you search for a function, do you want its API reference or a working example?

Screenshot 2026-11-02 181240
6likes6comments59Impressions
1Bookmark
Sign in to interact
Get to know meSign in to let's talk privately
Sign in to reply

6 replies

Tito Kiragu
Tito Kiragu@tito_kiraguLvl 8·Shipper·Nov 19
For me it depends on the moment. Early in a task I want the working example, because I'm trying to get something running. Later when I'm debugging I want the API reference, because the example told me what to try and now I need the exact behavior. Ranking by intent instead of keywords alone would be the version I'd reach for daily.
commentslikes
Paul Yorke
Paul Yorke@originforgestudioLvl 5·Builder·Nov 17
Building the crawler, indexer and ranking yourself is a big job for a solo launch. For me it depends on the function, an example first if I've never used it and the reference once I just need the parameters. Are you thinking of showing both side by side, or letting the query decide?
commentslikes
Konstantinos G
Konstantinos G@emarkssLvl 7·Active Builder·Nov 16
A third case next to the two in your question: a coding agent searching on someone's behalf. For that searcher I'd rank the reference for the exact version in the repo above an example, because an example written for an older release can carry a parameter that has since been removed.
commentslikes
Tito Kiragu
Tito Kiragu@tito_kiraguLvl 8·Shipper·Nov 16
Working example, almost every time. When I am stuck it is usually because I cannot picture how the pieces connect, and one example answers that faster than a full reference page. The reference then makes sense as the second click because I already know what I am looking at. Ranking around that intent, examples first and docs alongside them, is probably the edge most code search tools never bothered to chase.
commentslikes
Mark Rosario
Mark Rosario@markrosarioLvl 9·Dedicated·Nov 16
For me, the working example wins most of the time — I usually want to see the function doing something before I read what each parameter means. But I'd want the reference one click away from the example, not the other way round.
commentslikes
Ehsan
Ehsan@acadictiveLvl 8·Shipper·Nov 16
For community posts, try @nixfred, @mohamedsalah, @ioilmio, @sreeram4422, and @chinmaypingale. They have been active in other help categories and might have useful perspective.
commentslikes