DevDocs, the all-in-one API documentation tool for web developers, released its code on GitHub yesterday, officially becoming an open-source project. This is good news indeed. Now that anybody can contribute documentation, this already-amazing resource is only going to get better.
If you are a web developer and aren’t using DevDocs, you are seriously missing out. Here are a few reasons why.
Lots of Documentation All in One Place
DevDocs is a one-stop shop for (nearly) all of your documentation needs. It includes docs for core web technologies as well as various popular libraries and frameworks. This is the current lineup:
Core web: CSS, DOM, DOM Events, HTML, HTTP, JavaScipt
Libraries and frameworks: Angular.js, Backbone.js, Ember.js, jQuery, jQuery Mobile, jQuery UI, Lo-Dash, Underscore.js
Preprocessors: Coffeescript, Less, Sass
Server: Node.js, PHP
Do you use any of those in your development work? I thought so. Have you ever needed to look up a particular function signature, or the correct syntax of a CSS rule? Quit hunting around on Google and individual websites and use DevDocs! You’ll find it all here.
One thing I probably should have stressed when showing it to him is that DevDocs contains exact copies of the official documentations. Although they may be styled a little differently, the content is exactly the same, and so you don’t need to worry about missing something from the official site. It’s all there.
And if you’re worried that all those documentations will clutter up your search results with things you don’t need, worry no more. DevDocs allows you to select only the docs that you want to use and ignore all the others. You can tailor it to your specific work!
Lightning-Fast Fuzzy Searching
This feature is really what sells it for me. From what I’ve seen, DevDocs beats any official website’s search speed hands down. Results come up instantly as you type, and then you can quickly navigate to the right one with the keyboard and open it up in the main pane.
But what’s really great is that it supports fuzzy matching. If you use
Sublime Text, you know how great fuzzy matching is. What it means is that
you can type in a string of letters that aren’t necessarily contiguous, and it
will understand what you mean. Say, for example, I want to look up CSS
transforms. I can just type in
tfm, and “transform” will show up as the first
entry. Select that one, and I’m there. The whole thing took two seconds.
It’s also possible to namespace your searches. As I said before, DevDocs has
lots of different sets of documentation. If you want to, say, look up information
about jQuery events, you can type in
jq and then a tab. A “jQuery” label will
appear in the search field, and from then on your searches will be restricted to
the jQuery documentation (you can use backspace to get rid of the label and
restore the scope).
Oh, and you can also query straight from the URL, with our without namespacing.
/#q= and your query to the end of the app’s URL, and you’ll be
taken to the app with the search field prefilled, with the first result showing
up in the main pane. To get a namespaced result, simply prefix your query with
the namespace followed by a space. For example,
devdocs.io/#q=js trim takes
However you like to search, I’m telling you DevDocs is fast.
Now It’s Open Source
DevDocs has been out in the wild for several months now, but only yesterday did Thibaut Courouble, the developer, release the code for all to see and contribute to. This was a big step, and one that he clearly put a lot of thought into. There are several benefits to DevDocs being an open-source project.
For one thing, now it is possible to download your own copy of DevDocs and run it locally, meaning you don’t need an Internet connection for it to work. I haven’t tried doing that myself, but it could be a great option for some developers.
The more obvious benefit is now anybody can contribute to the project, both by improving the code of the app itself and by adding new documentation. Thibaut has given guidelines for contributing, so the way is now open for anyone to help. I expect that soon we’ll be seeing new documentations being added at an accelerated rate, and that can only be a good thing.
Use DevDocs Already!
I could talk about other features of DevDocs, such as its mobile interface, keyboard shortcuts, and OpenSearch compatibility, but hopefully what I’ve outlined here gives you reason enough to start using it. Seriously, I can’t think of any reason why a web developer wouldn’t want to use it—unless you had every bit of every documentation memorized.
So get over there and start using DevDocs to help your work. I guarantee it will make you happier as a developer.