Skip to main content

Angel Maldonado & Pedro Ondiviela - A New DevPortal Findability Experience: Holon Discovery

API The Docs 2023 Developer Success & Developer Portals Recap

This talk was presented at APIDays New York 2023, Developer Success & Developer Portals track on 17 May. We are glad to present the video recording and the talk summary.

Visit the talk listing page for an overview of all presentations!



Front-end Developer at



“An evolving and self-organizing system, where each holon is simultaneously a whole and part of something bigger…” - Arthur Koestler


Holon Search

Empathy Platform Docs approached the search feature differently to create more than just a conventional search.

  • Holon Search: Vector and Keyword search is an explainable, privacy-minded & extensible solution you can own and control.
  • The holon is a representation of complexity: it incorporates multiple parts, and yet represents the whole is greater than the sum of its constituent parts.
  • The most relevant result doesn’t have to be the first, and it can have a different shape, motion, and different relationships.
  • The search results set is not just a flat land, not a dumped out array or a list, which is a reflection of a computing mind.

Embracing new ideas to represent vectors, and the relevance with the depth and the complexity of their relationships between concepts is a key differentiator in Empathy’s Holon Search.

Development process

Backend - steps

  • Parser
  • Index plugin
  • Search plugin

Frontend - technologies

  • D3
  • Vue.js

Sign up to our Developer Portal Newsletter so that you never miss out on the latest API The Docs recaps and our devportal, API documentation and Developer Experience research publications.

Sign up


Articles on devportals, DX and API docs, event recaps, webinars, and more. Sign up to be up to date with the latest trends and best practices.