News for hackers. Stuff that matters.
Re:DevDocs by sleepytree on Friday January 12, 2024 @03:33PM (#38973622)
Not a complete answer, but I hope Markdown is or becomes the standard for offline docs and text for local/offline consumption. I only ever write in markdown anyway (usually with http://obsidian.md).

The closest thing I know of for a service like RSS to download documents is [Dash for macOS - API Documentation Browser, Snippet Manager - Kapeli](https://kapeli.com/dash).

Re:DevDocs by packetlost on Friday January 12, 2024 @04:15PM (#38974182)
There's also Zeal (https://zealdocs.org/) which is basically the same as Dash but open source and runs on non-Mac devices.
Re:DevDocs by mxuribe on Friday January 12, 2024 @04:27PM (#38974336)
I first learned of Zeal several months ago...and i really like it. But, i forget about havign zeal installed and available, that my reflex is to instinctively reach for duck duck go, or stack overflow, or somesuch search engine, etc. So, i just gotta build up the habit. :-)
Re:DevDocs by techwizrd on Friday January 12, 2024 @04:44PM (#38974548)
I understand completely. I even wrote an offline documentation browser [0] for Linux similar to Dash, and I reflexively search online too. It's a hard habit to break, but I think it's a UI/UX issue.

0: https://github.com/techwizrd/tarpon

Re:DevDocs by mxuribe on Saturday January 13, 2024 @09:09AM (#38980027)
First of all, thanks for reminding me that i'm not alone! :-)

Secondly, kudos on tarpon; very cool!!!

Re:DevDocs by 0cf8612b2e1e on Friday January 12, 2024 @05:36PM (#38975106)
Markdown is too anemic for documentation without extensions. Sure, you can make do, but I would rather wet standardized on something more powerful.
Re:DevDocs by djbusby on Friday January 12, 2024 @09:19PM (#38976733)
I'm still loving asciidoc. Loads of extensions too so I can have PlantUML and Mermaid stuff too
Re:DevDocs by SpaghettiCthulu on Friday January 12, 2024 @10:11PM (#38976987)
I agree. We need a standardized format with support for both structured (classes, methods, etc.) and unstructured (language overview) documentation..