News for hackers. Stuff that matters.
Re:DevDocs by johtso on Friday June 28, 2013 @05:58AM (#5957100)
If you're on a mac you might want to check out Dash http://kapeli.com/dash

Very simliar goal, but offline and instant. After using it for a while it's hard to imagine going back to reading documentation in a web-browser.

Re:DevDocs by Osmium on Friday June 28, 2013 @08:08AM (#5957490)
Love Dash (and own a license), but there was sadly some controversy regarding their new icon and "inspiration" recently. Will try and find a link...

Edit: so the old Dash icon was a free icon from http://www.yootheme.com/icons/freebies (the cat one). Recently this icon was replaced with a custom one, which makes sense, except the new Dash icon seems to be heavily "inspired" by somebody else's work -- http://dribbble.com/shots/913643-Chrome-replacement-icon

See the comparison here: http://twitpic.com/ciu8a7

Relevant tweets:

[Dash dev]

https://twitter.com/kapeli/status/328037766166368256

https://twitter.com/kapeli/status/328112260805451779

[Icon designer]

https://twitter.com/wakaba_en/status/328075341618892800

Seems like the Dash dev disagrees with the icon author on where the line between "inspiration" and "plagiarism" lies. It doesn't help that there's a language barrier between the icon author and Dash developer.

Icon designer even proposed an alternative icon:

http://dribbble.com/shots/1046492-Dash-app-replacement-icon

But sadly it seems like this issue hasn't been rectified, but has just been forgotten about. I only found out about this after I'd bought a license; I'm posting this here in case someone else finds it relevant to their purchasing decisions.

Re:DevDocs by atwebb on Friday June 28, 2013 @08:32AM (#5957576)
I'm not familiar with the controversy besides what you posted, but my take away is that icon dev has some talent. The bookcase D is clever and well done, at least at that size.
Re:DevDocs by isxek on Friday June 28, 2013 @10:32AM (#5958163)
In the link for the alternative icon, the icon designer has declined to enter any new discussions, as he felt "insulted" with the Dash developer's reactions on Twitter. He feels any more discussion is "a waste of time."

At any rate, I wish we non-Mac users had something like Dash.

Re:DevDocs by Osmium on Friday June 28, 2013 @12:26PM (#5958830)
In the interests of quoting the full context rather than just a few words, here's what he said in full:

"Dear The Great Developer of "Dash.app".

I do not ask you anymore. I do not say anything about your icon. It's a waste of time. But I am vindictive. Conversely, I inspired from your icon. This is the way of my protest. This time, you do not plagiarize this my icon, please.

Sayonara さよなら."

It seems the designer is Japanese, so there might be a language/cultural barrier too, but for what it's worth I think I would feel insulted by the Dash developer's reactions too!

Re:DevDocs by stock_toaster on Friday June 28, 2013 @06:02PM (#5960560)
Wow. That does seem like a rather blatant ripoff of the icon design.
Re:DevDocs by AaronO on Friday June 28, 2013 @07:45AM (#5957401)
I built http://doks.io

Which supports all the documentation Dash does. (The web UI is pretty simple, it was built in an evening).

But both the server side and the web UI are open source.

If you like Dash, you might like Doks

Re:DevDocs by chid on Friday June 28, 2013 @09:46AM (#5957914)
This seems nice. I wonder if this could be made into a ST2/3 client :)
Re:DevDocs by Siecje on Friday June 28, 2013 @04:34PM (#5960220)
I can't type quickly in the search field. Kind of a bid deal.
Re:DevDocs by zorbo on Friday June 28, 2013 @06:45AM (#5957223)
FYI, Apparently there is a clone for Linux called ZealDocs (http://zealdocs.org/).
Re:DevDocs by bliker on Friday June 28, 2013 @07:04AM (#5957269)
But only with fraction of content...
Re:DevDocs by zorbo on Friday June 28, 2013 @09:17AM (#5957767)
It seems to be compatible with Dash's DocSets, so you could use those on it.
Re:DevDocs by Legion on Friday June 28, 2013 @04:15PM (#5960113)
This capability is what took me from trying the Dash demo to paying for the app.

Once the content became something I could use on all my computers and not just the Macs, it became worth the money.

Being cool and cooperative with Zeal earned the Dash developer at least one sale.

Re:DevDocs by rafifyalda on Friday June 28, 2013 @06:06AM (#5957124)
Not to mention you can import and make your own DocSets, can integrate it with Xcode and much more. If you're developing anything on a Mac, you should probably have this installed (and pay to support it of course).

It's also a snippet manager, though I don't think many people use it for that purpose.

Re:DevDocs by orta on Friday June 28, 2013 @06:32AM (#5957193)
Dash has great support for CocoaDocs too so you can import open source libraries' DocSets. ( disclaimer: I made CocoaDocs. ) for example: http://cocoadocs.org/docsets/AFNetworking/1.3.1/
Re:DevDocs by ChrisLTD on Saturday June 29, 2013 @11:13AM (#5962599)
I love Dash, it's saved my butt when I've had spotty or zero Internet access. However, I've found that on my laptop it is far faster to do a web search for documentation than it is for Dash to do the search locally.
Re:DevDocs by adamauckland on Friday June 28, 2013 @06:39AM (#5957210)
I concur, Dash is ace and a godsend when coding far away from Internet access.
Re:DevDocs by frankcaron on Friday June 28, 2013 @08:14AM (#5957508)
Wow. I hadn't heard of this; looks amazing. Thanks for the heads up!
Re:DevDocs by endgame on Friday June 28, 2013 @05:55AM (#5957094)
Hey look, it's another submission where the title conveys the exact same amount of information as the URL.

Which is a shame, because it's actually a pretty neat-looking HTML5/css/jquery reference.

Re:DevDocs by tvon on Friday June 28, 2013 @10:28AM (#5958136)
I think it's fairly self explanatory, but the about page would have been a better submission:

http://devdocs.io/about

Re:DevDocs by maratd on Friday June 28, 2013 @11:44AM (#5958576)
No, a better submission would have been a title that says what it is.

The idea that I have to click to find out is nonsense. It's link-bait.

I would have never clicked if I knew it was docs for HTML/CSS/JQuery, no matter how slick.

I thought it was something more exciting, like a service where developers can submit their own docs and it's a central repository of sorts. Now that would have been interesting.

Re:DevDocs by nmcfarl on Friday June 28, 2013 @11:21AM (#5958454)
I’m not sure. I’d say allowing some editorialization in the title would have made a better submission.

Say, title: "DevDocs: An organized, and consistent interface to Web Documentation", with the same URL.

Re:DevDocs by tvon on Friday June 28, 2013 @11:50AM (#5958603)
You're right, I misunderstood the complaint.
Re:DevDocs by tlrobinson on Friday June 28, 2013 @11:39AM (#5958551)
Hey look, it's another top-rated comment that adds precisely zero to the actual discussion at hand.
Re:DevDocs by afarrell on Friday June 28, 2013 @08:30AM (#5957568)
This is awesome and I'm going to start using it today.

Suggestions: Look at what AaronO built and use it to add other sources.

Keep the current interface free, but let me pay some amount of money per year (or month?) to create an account and configure what sources it looks through. I'd like to have it search through django, python, git, and bootstrap docs as well.

Re:DevDocs by Thibaut on Friday June 28, 2013 @10:37AM (#5958195)
Thanks for the idea.

I built a flexible scraper for downloading and filtering the docs so you can except more sources to be added soon.

Toggling docs on and off is also on my todo list.

Re:DevDocs by inkel on Friday June 28, 2013 @11:38AM (#5958542)
Please add plain DOM documentation. I use jQuery, but I also use other libs or none at all, and having access to the DOM API would be wonderful.
Re:DevDocs by tklovett on Friday June 28, 2013 @10:37AM (#5958193)
Another option is to make offline support a paid feature.
Re:DevDocs by Thibaut on Friday June 28, 2013 @10:38AM (#5958204)
I was thinking the same. We'll see.
Re:DevDocs by AaronO on Friday June 28, 2013 @07:19AM (#5957312)
I built something similar a few weeks ago: http://doks.io

(It supports all major languages and frameworks) (And it's open source !)

Re:DevDocs by bliker on Friday June 28, 2013 @07:33AM (#5957356)
That is astonishing number of sources. But it is quite confusing when each source opens in different windows with different styling.

I wish there was some universal documentation format that could be shared among all software.

Re:DevDocs by lightcatcher on Friday June 28, 2013 @09:16AM (#5957764)
I think Sphinx (http://sphinx-doc.org/ ) is slowly becoming that.
Re:DevDocs by netcraft on Friday June 28, 2013 @08:46AM (#5957627)
Is there a place to suggest additional sources? Its quite the list, but there are a few more that I would use if you provided them.
Re:DevDocs by msy on Friday June 28, 2013 @07:05AM (#5957272)
I would love an interface like this for MDN's JS documentation.
Re:DevDocs by jaredgeorge on Friday June 28, 2013 @09:25AM (#5957811)
Re:DevDocs by 2mur on Friday June 28, 2013 @10:05AM (#5958019)
+1 (Or if I could get MDN's JS docs offline and in-browser (not Dash)).
Re:DevDocs by krakensden on Saturday June 29, 2013 @01:31AM (#5961572)
Or Boost, maybe.
Re:DevDocs by dewey on Friday June 28, 2013 @06:48AM (#5957230)
And if you are using Alfred (Mac) you could use http://wemakeawesomesh.it/alfred-dev-doctor/
Re:DevDocs by WickyNilliams on Friday June 28, 2013 @12:02PM (#5958678)
I agree, dev doctor is awesome! It integrates everything on devdocs and more (caniuse, MDN for instance). Works seemlessly with alfred, making doc lookups super quick.

Full disclosure: friends with author of dev doctor

Re:DevDocs by WestCoastJustin on Friday June 28, 2013 @02:53PM (#5959706)
Is this something that I can host locally, using my own documents, like on an internal network?
Re:DevDocs by proexploit on Friday June 28, 2013 @05:52PM (#5960528)
Doesn't look like it. See the about page, I think that's a pretty good indicator he intends to host it (although might be open to selling a license).

Why isn't this project open-source?

Ultimately I'd like DevDocs to provide me with some income so I can keep improving it over the long-term. Until I figure out how to do that I've decided to keep the project closed-source. If you have comments or ideas about this I'd love to hear them.

Re:DevDocs by roryhughes on Friday June 28, 2013 @06:26AM (#5957184)
Found a big bug: use up/down arrow keys to select an item on the left, then hit right and left keys to open and close the sub-lists. But, if you hit right twice or more it will append the sub list continuously below.
Re:DevDocs by Thibaut on Friday June 28, 2013 @08:39AM (#5957599)
Indeed. Thanks for the report! I'll fix it soon.

Edit: fixed

Re:DevDocs by skotzko on Friday June 28, 2013 @12:36PM (#5958889)
Although you have browser support covered on a doc-by-doc basis, I would find it useful to have a rollup page by browser of gotchas. e.g. all the common JS gotchas for IE8 (e.g. no go on client.innerWidth), IE9 not supported opacity, etc.

Here's a ghetto example of a reference file I started after recent project that drove me nuts which would give you the sense of what I mean: https://docs.google.com/spreadsheet/ccc?key=0ApBq5nqLSn9MdER...

Re:DevDocs by alan_cx on Friday June 28, 2013 @06:59AM (#5957256)
Just a feed back: For me, I click on HTML(1) in the menu on the left, and it expands below the page. There seems to be a thin scroll bar to the right to scroll down, but I cant grab it to scroll down. Only arrow keys and mouse wheel work. IMHO, scroll bar needs some work.

Edit: (1)Correction I click on HTML, then HTML5. Then the list goes below the bottom of the browser, then I cant grab the scroll bar.

Sorry for any confusion.

Re:DevDocs by Thibaut on Friday June 28, 2013 @08:36AM (#5957592)
Thanks for the bug report. I'll fix it soon :)
Re:DevDocs by mattfieldy on Friday June 28, 2013 @06:03AM (#5957112)
DocHub already exists that does the same thing but with more docs.

http://dochub.io/

Re:DevDocs by zorbo on Friday June 28, 2013 @06:12AM (#5957145)
For me, DevDocs is nicer at the moment:

- It's faster

- I don't have to select a programming language before I can start searching

- It handles keyboard input a lot better. As soon as the page loads, I can start typing, move down with the arrow keys and activate a selection with the enter key.

Re:DevDocs by alan_cx on Friday June 28, 2013 @07:00AM (#5957261)
Sure but it seems far less content. Maybe speed will suffer as content increases. Sites like this, IMHO, are about content, not speed.
Re:DevDocs by rrrene on Friday June 28, 2013 @07:09AM (#5957287)
Never underestimate the importance of responsiveness in user interfaces, especially when those interfaces are used look something up.
Re:DevDocs by chris_wot on Friday June 28, 2013 @06:12AM (#5957142)
Very cool - but when I'm on an iPad you keep bring up the keypad because you focus on search. Can you fix that?
Re:DevDocs by ajanuary on Friday June 28, 2013 @08:17AM (#5957519)
It seems odd that something that's just fetching and displaying snippets of HTML doesn't have a non-js fallback. But from the About it looks like this is a personal project made public in case anyone else finds it useful.
Re:DevDocs by niutech on Friday June 28, 2013 @08:27AM (#5957556)
There has been a nice predecessor since 2006: http://www.gotapi.com and http://start.gotapi.com
Re:DevDocs by dfasoebg on Friday June 28, 2013 @06:05AM (#5957117)
Really nice! It would be usable if it was free software so I could add docs for the different libs&langs I'm using. When it's closed, it's sadly not usable (although a very nice show).
Re:DevDocs by tomphoolery on Friday June 28, 2013 @02:03PM (#5959435)
Your browser version checker thing is wrong.

I am using WebKit nightly (which should be categorized under "Safari 5.1+"), and it gave me a warning that said my browser was unsupported. As a user of a potentially unstable browser, I don't mind when sites freak out because it's usually something I can report back to the WebKit team. So I'd really like to see if my bleeding-edge Safari (I guess this would be 6 technically?) can run DevDocs… :)

Re:DevDocs by Thibaut on Friday June 28, 2013 @02:14PM (#5959510)
Yes, sorry. I deployed a bug that blocked all browsers for a couple of minutes. It's fixed.
Re:DevDocs by FreshCode on Saturday June 29, 2013 @06:08AM (#5961920)
Any chance of releasing the theme within a styling framework like Bootstrap? This would be amazing for some of our internal tools and documentation.

Edit: I see the author responded to "Why isn't this open-source?" on the About page, http://devdocs.io/about

Re:DevDocs by momo1 on Friday June 28, 2013 @11:11AM (#5958401)
This looks very promising!

Here's a suggestion. My favourite source for Rails docs is apidock.com because it allows people to comment and supply examples. It would be really nice if devdocs could incorporate something like that or perhaps even a wikipedia-like way to update the docs.

Re:DevDocs by Flenser on Friday June 28, 2013 @06:19AM (#5957161)
In Chrome if I right click in the search box and add it as a search engine it doesn't work :(
Re:DevDocs by frankcaron on Friday June 28, 2013 @08:13AM (#5957506)
As a long time technical writer, allow me to convey my sheer joy at how awesome this is. Issues with the submission and its descriptiveness in terms of HN standards aside, this is super wicked awesome and makes me warm and fuzzy inside.
Re:DevDocs by Thibaut on Friday June 28, 2013 @08:38AM (#5957596)
Thanks! :)
Re:DevDocs by bobsy on Friday June 28, 2013 @07:31AM (#5957351)
Looks awesome. Very useful.

How is this site made? It looks like changing pages are ajax transitions but the url is changing at the top? Could someone point me in the direction of how this is made please. Would be really interested.

Re:DevDocs by chrisboesing on Friday June 28, 2013 @07:48AM (#5957409)
Without looking at the source, I would say it is using the History API introduced in HTML5.

Here is a nice article describing it: http://diveintohtml5.info/history.html

A simple example with source can be found here: http://html5demos.com/history

Re:DevDocs by nekgrim on Friday June 28, 2013 @07:44AM (#5957399)
Re:DevDocs by bobsy on Friday June 28, 2013 @07:49AM (#5957414)
Thanks a lot. I have a seen a few sites like this and have been wondering. Sites using this feel like they load so much faster and more fluidly.
Re:DevDocs by publicfig on Friday June 28, 2013 @11:25AM (#5958474)
I'm not sure that it's the only reason why IE isn't supported, but currently no version of IE supports the history api, which is a bit of an annoyance if you aren't developing a site that you can block certain browsers from using.
Re:DevDocs by robinduckett on Friday June 28, 2013 @07:43AM (#5957393)
HTML5 history.pushState
Re:DevDocs by jpreiland on Friday June 28, 2013 @10:47AM (#5958261)
The nav tree doesn't seem to remember which items I had expanded if I collapse the parent and then open it back up. Is this intentional?

Very cool resource, though. Thanks!

Re:DevDocs by Thibaut on Friday June 28, 2013 @10:57AM (#5958321)
Thanks! It's intentional because I haven't had the time to implement it yet. ;)
Re:DevDocs by CoachRufus87 on Friday June 28, 2013 @08:56AM (#5957672)
Reminds me of: http://ruby-docs.com/
Re:DevDocs by scottohara on Friday June 28, 2013 @10:00AM (#5957989)
Oh this is so much nicer to read through than other sites.

Favorited!

Re:DevDocs by thameera on Friday June 28, 2013 @11:10AM (#5958395)
TIL that sup is obsolete HTML, while sub is not.
Re:DevDocs by Thibaut on Friday June 28, 2013 @11:17AM (#5958437)
Added to my todo list. Thanks!
Re:DevDocs by zv on Friday June 28, 2013 @07:53AM (#5957425)
Sweet. Can you please add javascript reference?
Re:DevDocs by Thibaut on Friday June 28, 2013 @08:39AM (#5957601)
Thanks. I built a very flexible scraper underneath. JS/DOM docs are coming soon.
Re:DevDocs by waawal on Friday June 28, 2013 @05:38AM (#5957048)
This is really great! I will probably use this.

Thanks