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.
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. :-)
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.
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.
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..
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).