A Look at DevDocs.io

Bruno Skvorc
Bruno Skvorc
Share

How often do you go through the following process when coding?

  1. Need a [insert programming language here] function definition and examples
  2. Google for said function
  3. Click first result which is either w3schools if you’re out of luck, or the online manual of the language you’re dealing with.
  4. Realize you need another function demoed and explained
  5. Go back to Google instead of using the search on the language’s website because it’s inexplicably awful and slower than actually reloading the tab after a new Google search
  6. Rinse and repeat

As a developer who deals in web technologies to a great extent, I’ve encountered this quite a lot. Simply finding the technical definition of a function or statement has become far more difficult than it ever should have been – not in terms of complexity, but in terms of time wasted. Wouldn’t it be great if we could have all our development docs in one place, in a beautiful, offline-enabled interface with a super fast fuzzy search, for any language? Enter devdocs.io.

What is it?

DevDocs is a web app aimed at providing you with quick access to the reference manual of just about every front-end language and library. It lists all the APIs of a given selected language and their official documentation in an easily browsable and viewable format, without the needless menus and tacky attempted styling that official sites like php.net try to pull off.

It’s an Ajax-driven and open source web app with syntax highlighting, even available as a Chrome extension or as a plugin for Sublime Text or Brackets.

enter image description here

What does it do?

It aggregates the reference manuals of all popular languages (provided they have their manuals in an easily accessible and machine-consumable format). It provides you with a slick and fast interface for fuzzy searching the documentation of all selected languages, in order to find the information you need in as few key presses as possible. What’s fuzzy searching, you may be wondering? Fuzzy searching is searching for a string that approximately (not exactly) matches what you entered. It’s what editors like Sublime Text and LightTable use for their command search windows – entering something like “sa” will give you “Save As..”, because the input matches the initials of the command. Entering “delte” will offer results containing “delta” and “delete” and entering “bgcp” will even give you “background clip”. This type of search allows for super-fast fine tuning of results, and since they’re real-time, you can mix and match on-the-spot.

enter image description here

Content

DevDocs downloads the index of the reference manual for the language you select, absorbing it into your local cache from where it serves the results. This does mean you have to redownload the languages of your choice on every new machine, but the speed gain from such a means of operation is far superior to the old fashioned Ajax way of doing things with remote requests. Mind you – currently, only the index is offline, the actual result you click is served from a remote location – for example, you still need internet access to fetch the document for JavaScript Arrays, even though it shows up in the search results even when offline.

enter image description here

It’s important to note that the contents fetched are official-only. This means user submitted entries like comments and samples are ignored.

You can search DevDocs in a specific language scope (for example PHP only) by prefixing your search query with “php” and hitting tab or space (on mobile). This switches search mode to “selected language only”. To exit this mode, simply backspacing out of it does the trick.

enter image description here

Open source and local

DevDocs is open source and encourages the community to contribute in a variety of ways. First off, it’s on GitHub, and invites users to submit issues and improve the code, like any good open source project. Secondly, DevDocs can easily be deployed locally, so you can run or host your own version. Adapting it to, for example, the API of your company’s internal system is a breeze. Last but not least, DevDocs uses Trello to gather user feedback on desired languages. Trello, a very efficient team based task list, supports various boards of information where people can collaborate, discuss and vote for cards (topics). DevDocs uses these cards to collect votes for individual language integration. To participate, see here.

enter image description here

DevDocs is maintained and updated regularly, and provides various means of keeping up to date with the changes:

All of these seem to be drawing from the same source, so it’s best to subscribe to just one of them.

Other perks

DevDocs is fully optimized for mobile devices, and highly responsive. It opens in a flash, and works exactly the same on mobile as it does on desktop. It’s built the way websites were always meant to be built – a smooth, fast and identical experience on every device. Thibaut Courouble really did a fantastic job.

enter image description here

As mentioned, the app installs as a plugin for Sublime Text and Brackets – meaning you can search for the API you need right from your editor. More plugins are on the way, most notably JetBrains product plugins. The app is also being ported to a standalone zero-configuration downloadable offline version.

DevDocs can be installed as a search engine in Firefox and Google Chrome, and basically any other browser and app supporting OpenSearch. OpenSearch is a collection of standards allowing a certain resource to identify itself as a search engine.

A variety of keyboard shortcuts are offered too, all intuitive and very useful, providing a truly smooth experience.

enter image description here

Conclusion

If you haven’t heard of DevDocs before reading this article, I fully encourage you to give it a go. The web is in dire need of such highly usable resources, so spread the word and help the community find better solutions to problems they’re dealing with. If you can contribute, DevDocs is on GitTip and supports PayPal donations – but arguably the best way to help out is to just use it, tell others about it and, above all, improve it by contributing to the project on GitHub.

Frequently Asked Questions (FAQs) about DevDocs.io

What makes DevDocs.io different from other documentation platforms?

DevDocs.io stands out from other documentation platforms due to its simplicity, speed, and user-friendly interface. It combines multiple API documentations in a fast, organized, and searchable interface. Unlike other platforms, DevDocs.io allows users to download the documentation for offline use, making it accessible even without an internet connection. It also supports keyboard shortcuts for easy navigation.

Is DevDocs.io free to use?

Yes, DevDocs.io is completely free to use. It is an open-source project, which means that not only is it free, but users can also contribute to its development. This makes it a community-driven platform that continuously evolves based on the needs and feedback of its users.

How does DevDocs.io ensure the accuracy of its documentation?

DevDocs.io pulls its documentation directly from the official sources, ensuring that the information provided is accurate and up-to-date. The platform also allows users to contribute corrections and updates, further enhancing the accuracy of the documentation.

Can I use DevDocs.io offline?

Yes, one of the key features of DevDocs.io is its ability to work offline. Users can download the documentation they need and access it anytime, anywhere, without an internet connection. This makes DevDocs.io a reliable resource for developers who may not always have access to the internet.

How can I contribute to DevDocs.io?

As an open-source project, DevDocs.io welcomes contributions from its users. You can contribute by reporting bugs, suggesting improvements, or even writing code. All the information needed to contribute can be found on the DevDocs.io GitHub page.

Does DevDocs.io support mobile devices?

Yes, DevDocs.io is fully responsive and works well on mobile devices. This means you can access the documentation you need from your smartphone or tablet, making it a versatile tool for developers on the go.

How often is the documentation on DevDocs.io updated?

DevDocs.io strives to keep its documentation as current as possible. The frequency of updates depends on the source of the documentation. For instance, if the official documentation is updated, DevDocs.io will reflect these changes as soon as possible.

Can I customize the interface of DevDocs.io?

Yes, DevDocs.io allows users to customize the interface according to their preferences. You can choose which documentations to display, adjust the layout, and switch between light and dark themes.

Does DevDocs.io support all programming languages?

DevDocs.io supports a wide range of programming languages and technologies, but it may not cover every single one. The platform focuses on the most commonly used languages and technologies in the industry.

Is there a community or forum for DevDocs.io users?

While DevDocs.io does not have a dedicated community or forum, users can interact and contribute through the platform’s GitHub page. Here, they can report issues, suggest improvements, and discuss with other users and contributors.