"Shift+K" does the same in vim. However, it looks for a manpage matching the word under the cursor, so it won't help you unless you're doing C or Perl.
I saw this a while back and it seemed amazing but I was wondering if there's any way to open the actual live documentation page. So for example if you choose the documentation for `Array.prototype.map` then it'll pull up that page on MDN, rather than the locally cached Dash page.
I know the whole point of Dash is to have locally cached, offline documentation copies, but I was thinking it would be amazing to use that to feed Helm candidates, but actually open the real, live documentation page.
This was my first thought, as well. I use Dash several times a day. It has been indispensable for me.
There are a few main things that will probably keep me on Dash, for the time being. In no particular order:
1. Global shortcut - Being able to quickly show-search-hide from anywhere is extremely useful for me. I can quickly refresh myself on the syntax of an uncommon function. The faster I can do that, the less likely I am to break my flow.
2. Support for random/obscure projects - On top of community-added docs, Dash lets you point it at any random GitHub project and it will pull down the README. This has come in handy plenty of times for me when using small tools and components. Sure, it's not as nice as full documentation, but it's nice having that README searchable in the same place and offline (see reason #1).
3. Docsets - Dash lets you define groups of frameworks (etc.) and name them. You can even specify which version of a framework to use in the docset. This allows me to tailor my results to a particular stack, depending on which project I'm currently working on.
What? That link doesn't have any proof that "the Dash author has engaged in unethical practices". Neither any other link I could find about the whole controversy. Actually, everyone seems to be saying things are complicated, what seemed to be true actually wasn't, it's hard to take sides, etc:
Gruber makes it pretty clear in your link that the author of Dash engaged in unethical practices, just not with the Dash app (or the account used to publish Dash). Heck, publishing the phone call alone is unethical, regardless of any of the alleged app review behavior.
I think you or the mods should remove your comments because they are potentially defamatory. There is indeed no evidence that the Dash author himself was responsible, he says it was a family member.
“Almost 1,000 fraudulent reviews were detected across two accounts and 25 apps for this developer so we removed their apps and accounts from the App Store,” Apple spokesperson, Tom Neumayr
They’re allegations, sure. I said that in my second comment. But Tom didn’t hedge his words there.
Well, what is clear to me is that another account, not Dash's author's, engaged in unethical practices. The author said it was a family member, but I can't verify that, so it is still unclear.
Publishing the phone call was kinda dumb, yeah, but it's still pretty far from "engaging in unethical practices". It seems more like a guy feeling cornered, acting under pressure and making bad decisions.
This a most irresponsible post. The situation was somewhat complex and not easy for outsiders to parse out of the crossfire. You state one side's position as fact, quoting only one highly tendentious Gruberish Apple protagonist in support. Is this how fairly you'd like to be treated in public if you got into a spat with a major company? Please have a little thought for the welfare of others before you type.
In any case, it's water long under the bridge now, and Dash is an excellent app used my many developers (including within Apple). Trying to poison the well is in pretty bad taste.
Doesn't seem like a particularly complex case to me.
Facts not up for debate: the developer of Dash enrolled two accounts in the ADP with the same credit card, and these accounts shared at least one test device.
One of these accounts participated in obvious fraudulent activity.
Unfortunately, nobody is around to corroborate Bogdan's side of the story. As far as we know, Bogdan made up his supposed relative/friend (ala "I didn't send that embarrassing text to my crush - it was my asshole friend!") to escape blame. And even if his side of the story is true, how is he not partially culpable for the fraud? By enrolling an account with his credit card and giving it to someone else, he enabled them to commit fraud on the App Store. If I buy a gun and give it to my brother and he shoots someone, am I not partially responsible for that outcome?
It's not quite damning enough for me to not use Dash, but it doesn't exactly give me faith in Dash's developer either.
I found it slow. Also, just remembering this now but I came in to work one morning only to be questioned as to why I was downloading GBs of data while I was out of the office. I guess Dash was refreshing the local copy of all the docs every night. Uninstalled it right away.
Slow? It's insanely fast on my 6 year old desktop and doesn't download "gigs" of docs every night...also, what kind of workplace monitors individuals net usage then gets upset at them for downloading "gigs" when their job is to program.
It also packs well as a fluid app if you'd prefer a standalone (and fluid doesn't seem to purge the cache and lose offline mode like your browser might)
Ditto, and I don't even mean it in a bad sense. After you get used to it, this really isn't that bad, this format seems to work for PHP. I'd even say, that because of that PHP docs turn out to be quite better than "clean and nicely written" ones for other platforms.
Due to some very annoying behaviour of gratipay (the donation service devdocs uses) I have donated over $100 to them last year of the course of a few months. Not what I wanted to donate, but then again there aren't many websites that I use more often in my day to day work. So I am not too bummed about it.
Interesting, I don't use the daily, but when I need, I REALLY need it. How come you use it that often is it your main go to? My day to day is mainly googling as a portal to stackoverflow for specific doubts.
It is my goto yes. I use it anywhere from checking how some method or function is named again to finding out what I can do with certain types of objects or classes. The search is really practical for me there. I also peek into the source code of functions etc. it is the only pinned tab I have usually.
Don't feel like you have to donate, though. The app is cheap to host (one of the benefits of an offline-enabled, no-accounts-required, optimized-to-the-max web app is that the backend doesn't do much :P), and I'm lucky that MaxCDN & others are providing free service to the app.
What keeps me going is seeing the impact that DevDocs is having (people using and liking it). So the best way to "give back" is to spread the word, send a thank you note, and contribute (one thing in particular that would be great to see is more/better extensions & integrations with code editors).
I've been thinking about writing blog posts on DevDocs's internals and the techniques it uses for a while, but it's hard to find the time, especially when I already spend a lot of my spare time maintaining/updating the app.
That said, feel free to open a GitHub issue to remind me to write blog posts at some point (if there is interest), or if you have specific questions.
Could you specify more on the front-end code on this project, did you hand-roll your own javascript front-end or did you use a framework? The whole thing is rather impressive and I'm looking to do something similar to your sidebar with my own project. Is all of your open source code open to be re-used/modified?
DevDocs is old, roughly 4 years or so; I know it from the beginning.
That being said, not every HackerNews reader is aware of every single project in the wild, so re-posting the link from time to time is a good idea, not only to let more people know about it but also to increase the contributions and donations which may be forgotten after the popularity fades away. I can see this re-posted many more times in the future.
Remember that every year new Computer Science students graduate and and they are going to be the ones saying "First time I see this project" next year. So let the re-posts flow no matter what.
Surprised that R isn't on there since it is a top 10 language. The ecosystem though is pretty huge and R Base without Hadley Wickham's tidyverse isn't very useful for me.
I've used this off and on for a while, but the hardest thing for me is breaking the google habbit (or ddg as often as not in my case) and actually performing the search on that site.
I can !dd with duckduckgo to get to devdocs, but I wish there was some natural language processing that knew I wanted to look up a cpp/rust what have you term and send me there.
Additionally, C# doesn't seem to be included, which is a big bummer.
I don't think there's any reason to use this for Rust, honestly. You'll want to unify your dependencies using `cargo doc` and then just browse std documentation on https://doc.rust-lang.org/std/ (and other stuff on docs.rs)
Rust has spoiled me so bad with cargo doc. Even Python feels like a fossil when I can generate a linked doctree in my target directory and use it offline / on demand and generate them immediately and effortlessly if I ever need to fork / patch / use git / etc anything.
According to the docs (http://devdocs.io/help#search) you can actually integrate DevDocs into your search habits by using the browser bar search (on Google Chrome, at least).
Go to search bar -> type in 'devdocs' -> hit tab ("Search DevDocs"). You can then search directly.
144 comments
[ 2.6 ms ] story [ 55.5 ms ] thread1: https://kapeli.com/dash
Disclaimer: I'm the maintainer of DevDocs
As a long-time dash user in the past, devdocs felt like home and just works nicely and without any unnecessary features.
For what it’s worth on Linux the open source alternative is Zeal
https://zealdocs.org/
https://github.com/sunaku/dasht
https://github.com/rhysd/devdocs.vim
[1]https://github.com/sunaku/dasht
[2]https://github.com/sunaku/vim-dasht
Also, works on GNU/Linux and Windows. Also, free software. Also, I'm the co-author.
I know the whole point of Dash is to have locally cached, offline documentation copies, but I was thinking it would be amazing to use that to feed Helm candidates, but actually open the real, live documentation page.
It seems there are some docsets already doing that[1]. Creating your own docsets is dead easy. just a simple sqlite3 file with a single table.
You can find an example I hacked myself here[2] (very hackish).
It's basically creating a table:
And filling it with data: [1]. https://github.com/areina/helm-dash/issues/65 .[2]. https://github.com/kidd/AllegroLisp.docset
The helm-dash repo tagline on GitHub says "Browse Dash docsets inside emacs", so I quickly dismissed it as I don't use Mac.
Reading a bit further, now I see that it doesn't need Dash to be installed. So that's great! I'll see if an ivy/counsel version is out there.
Yep, helm-dash can download docsets from dash servers and use them without the need of Dash whatsoever.
https://github.com/nathankot/counsel-dash .
Enjoy!
There are a few main things that will probably keep me on Dash, for the time being. In no particular order:
1. Global shortcut - Being able to quickly show-search-hide from anywhere is extremely useful for me. I can quickly refresh myself on the syntax of an uncommon function. The faster I can do that, the less likely I am to break my flow.
2. Support for random/obscure projects - On top of community-added docs, Dash lets you point it at any random GitHub project and it will pull down the README. This has come in handy plenty of times for me when using small tools and components. Sure, it's not as nice as full documentation, but it's nice having that README searchable in the same place and offline (see reason #1).
3. Docsets - Dash lets you define groups of frameworks (etc.) and name them. You can even specify which version of a framework to use in the docset. This allows me to tailor my results to a particular stack, depending on which project I'm currently working on.
EDIT: I should read :)
http://www.loopinsight.com/2016/10/10/apple-responds-to-dash...
[1] https://blog.kapeli.com/dash-for-ios-back-on-the-app-store
https://daringfireball.net/2016/10/apple_dash_controversy
They’re allegations, sure. I said that in my second comment. But Tom didn’t hedge his words there.
Publishing the phone call was kinda dumb, yeah, but it's still pretty far from "engaging in unethical practices". It seems more like a guy feeling cornered, acting under pressure and making bad decisions.
In any case, it's water long under the bridge now, and Dash is an excellent app used my many developers (including within Apple). Trying to poison the well is in pretty bad taste.
Facts not up for debate: the developer of Dash enrolled two accounts in the ADP with the same credit card, and these accounts shared at least one test device. One of these accounts participated in obvious fraudulent activity.
Unfortunately, nobody is around to corroborate Bogdan's side of the story. As far as we know, Bogdan made up his supposed relative/friend (ala "I didn't send that embarrassing text to my crush - it was my asshole friend!") to escape blame. And even if his side of the story is true, how is he not partially culpable for the fraud? By enrolling an account with his credit card and giving it to someone else, he enabled them to commit fraud on the App Store. If I buy a gun and give it to my brother and he shoots someone, am I not partially responsible for that outcome?
It's not quite damning enough for me to not use Dash, but it doesn't exactly give me faith in Dash's developer either.
Behaves like a substitute for man pages with most useful examples. Saved me hours of googling and searching.
Great work guys!
Don't feel like you have to donate, though. The app is cheap to host (one of the benefits of an offline-enabled, no-accounts-required, optimized-to-the-max web app is that the backend doesn't do much :P), and I'm lucky that MaxCDN & others are providing free service to the app.
What keeps me going is seeing the impact that DevDocs is having (people using and liking it). So the best way to "give back" is to spread the word, send a thank you note, and contribute (one thing in particular that would be great to see is more/better extensions & integrations with code editors).
(I'm the creator/maintainer of DevDocs)
I've been thinking about writing blog posts on DevDocs's internals and the techniques it uses for a while, but it's hard to find the time, especially when I already spend a lot of my spare time maintaining/updating the app.
That said, feel free to open a GitHub issue to remind me to write blog posts at some point (if there is interest), or if you have specific questions.
edit: nvm. I found it: https://marketplace.visualstudio.com/items?itemName=akfish.v...
All of the code is licensed under MPL 2.0 [1], so you're welcome to reuse/modify it in your own projects.
[1]: https://github.com/Thibaut/devdocs/blob/master/LICENSE
You can submit pull requests to add new docs if you're so motivated.
Happy our paths crossed again here!
Take a look at [0] and see if it would be worth the trouble of adding it yourself or at least starting the process.
[0] https://github.com/Thibaut/devdocs/blob/master/CONTRIBUTING....
It seems that this time it got more traction. Good luck with your project!
That being said, not every HackerNews reader is aware of every single project in the wild, so re-posting the link from time to time is a good idea, not only to let more people know about it but also to increase the contributions and donations which may be forgotten after the popularity fades away. I can see this re-posted many more times in the future.
Remember that every year new Computer Science students graduate and and they are going to be the ones saying "First time I see this project" next year. So let the re-posts flow no matter what.
* It links to the real documentation
* world class search
* lets you pick and choose versions and languages/frameworks you want to have searchable
* provides a consistent UI across all docs which is fantastic when you are switching between several while developing.
* Is updated with terrifying frequency (I don't think I've ever opened it and NOT had some kind of docs update notification!)
* There are editor plugins available that let you press a key and open the highlighted word as search in devdocs.io
If you use devdocs.io and feel like it has saved you time or money, donate to them on Gratipay [0].
[0] https://gratipay.com/devdocs/
* Ability to tab-select [1] a language to limit your search to.
The lack of this feature in Zeal [2] is one of the reasons I stay with devdocs although i tend to like old-school real desktop apps.
[1] (Write the lang and press tab)
[2] https://zealdocs.org/
Here's a list of all published Elm modules pointing to their respective packages: https://github.com/fiatjaf/module-linker/tree/backends/data/...
Scraped with this simple fish script: https://github.com/fiatjaf/module-linker/blob/backends/data/...
Compare these two pages:
https://devdocs.io/javascript/global_objects/array/entries
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Refe...
I think the blue "sections" on devdocs are really <h3> so they are not sections at all and it throws me off.
Also would love to see Racket notes.
(I'm the author.)
I can !dd with duckduckgo to get to devdocs, but I wish there was some natural language processing that knew I wanted to look up a cpp/rust what have you term and send me there.
Additionally, C# doesn't seem to be included, which is a big bummer.
Go to search bar -> type in 'devdocs' -> hit tab ("Search DevDocs"). You can then search directly.
It's pretty awesome.