What's your preferred granularity of docs?
(a) A whole module on one page, e.g. https://pkg.go.dev/time, making search easy?
(b) A function per page, e.g. https://www.php.net/manual/en/function.time.php, giving more space for examples and See Also sections?
I'm torn, and I've seen both done well.
miniblog.
Related Posts
I'm increasingly treating terminal sessions as short lived: starting a fresh terminal tab keeps scrollback short and easy to search.
I'd love to have a terminal emulator that allows me to skip over output of specific verbose commands when searching.
I've been working on a search tool for a website with 9K items and a dumb implementation works just fine. I'd normally gravitate to a library or tool like elasticsearch (ES).
Adding custom filters etc is trivial on handrolled code. I wonder what scale requires actual search infra like ES.
One advantage I've come to appreciate about Dash/Zeal docsets: it's really nice having focused search.
The text search is constrained to the languages I care about enough to download the docset, substantially increasing the relevance. In Google I'd need to specify the language.