Welcome to APIdia

APIdia is an API documentation platform with initial focus on Java. The starting point is to resemble JavaDoc while solving a number of painpoints – long-standing ones as well as recently introduced ones. For the time being, hosted projects are cherry-picked and user requests are considered. Eventually, there will be a process offering more control to users and maintainers.

Most importantly, APIdia restores the well-established three-frame project navigation in a future-proof way (referring to EOL of frame and frameset html elements). While you browse APIdia, the site maintains a parameterized url storing frame states suitable for linking and bookmarking.

Another major improvement is rigorous interlinking both within a project (including links to imports and overridden, implemented, hidden methods) and accross distinct projects. For nearly every project hosted on APIdia, the entire dependency tree is hosted as well. You will rarely find an object type or member name that is not linked to its API documentation.

Summaries come with tooltips for method args and are processed in a smarter way. They do not prematurely terminate at abbreviations like "e.g.". Methods indicate overridden, implemented or hidden methods by a link. Docs always include private and internal API, which is hidden by default and can be activated via the top right menu.

APIdia's search is notably faster than Javadoc's – it reacts instantaneously on typing. Furthermore, it supports regex and has a clean design that makes smart use of sticky html elements for presenting the dropdown search results. The whole site is lightweight and swift. It avoids heavy scripts, frameworks and analytics, allowing operation without annoying cookie banners. And of course, APIdia is free and will stay free.

That said, the best way to get an impression is to just delve into some of the docs. Check out the Java standard library, Jakarta EE, Guava, JavaFX, JUnit, Bouncy Castle, Netty and many more.

How APIdia can help you

If you are using Java professionally, you will notice that browsing API documentation with APIdia is smooth and efficient. The navigation and search are more snappy than the status quo. You can easily examine dependencies and branch out into their docs or look at internal API.

Are you a core developer of a library? If your library is hosted on APIdia, you can effortlessly browse internal API of a complex code base. You can instantly switch back and forth between private and public API to assess the user experience of your library documentation.

For learners starting to use the standard library and popular utility libs, the three-frame structure provides a unique way to explore API at their own pace while always keeping a good overview. Javadoc replaced project navigation by a search, but browsing and searching are really two things. Especially as a learner, you hardly know what you should be searching for from the start. Browsing and exploring helps you understand a project and its design choices.

The benefit to learners is of equal relevance to educators. If you are an educator, you can use APIdia to familiarize your students with the structure of libraries. Do you want to use APIdia in your programming course? Tell us about it and we may feature your course on the page.

For all developers, APIdia provides a documentation look and feel that is going to be stable and reliable in the long run. No crucial features will be taken away. We understand developers and know how annoying it is when changes are made just for the sake of change. We know how tiresome it is when products degenerate to bloatware. We understand the importance of a fast, lightweight and professional site. These values are baked deeply into APIdia and are here to stay. That is our promise. Let us earn your trust.

How you can help APIdia

First of all, become a user. A lot of work went into APIdia to make developers' lives easier. APIdia is a fairly new site and its user base must still develop. By using APIdia, you create a win-win relationship.

Spread the word. Show APIdia to your colleagues and follow us on Mastodon @APIdia@mastodon.social, BlueSky @apidia.net and Twitter @apidia_net (some call it X these days). We follow back every person or organization displaying a Java or other tech background in the profile description or posts. We repost professional posts about Java, programming or related community events from our followers as we see fit. Drop us a note if you think we have overlooked an important post. If you have a question about APIdia, please ask it on StackOverflow.

If you have a feature request, open a discussion on our Github page. Tell us if a project of relevance to you is missing on APIdia. Same for (specific) legacy versions or pre-releases of hosted or yet unhosted projects. Do you want to host API documentation of a closed-source project? Get in touch. We offer a process to submit API documentation data without having to share the source code. Still suffer from a painpoint? Let us know!

If you are a library maintainer, place the APIdia badge in your readme, e.g. on Github. Drop us a note if your library is not hosted on APIdia yet – we will process it with priority.

Become a partner. Are you running a Java, programming or tech website or a small company? Let's cooperate. We are launching a program to feature projects or organizations that adopt APIdia for their docs, blog about it, use it for education or some other case. Get in touch and tell us your use case!

Become a sponsor. As part of the same program, we will present sponsors on APIdia. Furthermore, sponsors will be mentioned in our social media posts and in talks on JUG meetings and conferences. Contact us to learn more!

Contact

Please get in touch via the official contact form or email. We are looking forward to your message!