Making world-class docs takes effort

Re:Making world-class docs takes effort by mukundesh on Saturday September 04, 2021 @09:00AM (#28414699)

I hate viewing documentation in a browser, too many distractions. Everyone should distribute docs in a dockset format (https://kapeli.com/docsets).

[ Parent | on HN ]

Re:Making world-class docs takes effort by ofrzeta on Sunday September 05, 2021 @02:26AM (#28422016)

That's a good opportunity to mention Zeal, an open source Dash alternative: https://github.com/zealdocs/zeal

[ Parent | on HN ]

Re:Making world-class docs takes effort by nzmsv on Saturday September 04, 2021 @10:19AM (#28415316)

Huh, looks like a modern-day WinHelp. That looks like it's moving in the wrong direction though. I doubt many people want a big completely offline doc blob in this day and age.

[ Parent | on HN ]

Re:Making world-class docs takes effort by eddieh on Saturday September 04, 2021 @03:30PM (#28418287)

Actually, I wish more projects had installable documentation. Obviously, I don't want WinHelp, but man pages, HTML, and PDFs easily installed to a discoverable place, yes please.

[ Parent | on HN ]

Re:Making world-class docs takes effort by mdaniel on Saturday September 04, 2021 @11:55AM (#28416177)

In my experience, local copies load appreciably faster and more consistently than CDN-ed, Google Analytics-ed hosted copies

I'm beyond livid that Firefox Developer Edition stopped allowing me to paste "jar:" protocol URLs even though it still loads the existing ones I bookmarked just fine

[ Parent | on HN ]