Skip to main content

Articles

Everything on developer portals from strategy and business to technology and visual design.

Sign up to our newsletter to make sure you don't miss out.

by Kristof van Tomme 7 years 6 months ago

Graph databases in Drupal: a Neo4j module that integrates with Rules

SQL databases are really fast when you need all the information stored together in a record row, but they are a bad fit when you need to search for relationship patterns that are not already stored together in your database. A significant performance penalty is incurred for every additional table that needs to be joined for a query. That is why SQL databases are notoriously bad at deducting relationships from datasets. Graph databases however are really good at this task.
by Kathleen De Roo 7 years 6 months ago

Software Development Kits (SDKs)

The main purpose of Platform Software Development Kits and Helper/Client Libraries is to accelerate and simplify development. A well maintained SDK is a trust signal that indicates the level of support and usage of your API for a language, framework, or development platform. In this post, we’ll look at how the developer portals in our research sample included SDKs.
by 7 years 7 months ago

5 Things to Learn from Twilio’s Documentation Overhaul

Twilio is regarded as one of the API industry’s leaders, so when, after five years, Twilio changes the documentation format on their developer portal, everybody wants to know why. Jarod Reyes and Andrew Baker (both developers of Twilio's developer education team) gave a presentation about the reason for the changes at SIGNAL 2016. Because we found them valuable and wanted to share them with our developer portal mailinglist, we’ll summarize their findings in this blog post.
by Kristof van Tomme 7 years 9 months ago

Software Support and Artificial Intelligence - Part 5: Automated proactive support as messages

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables. __Part 5: Automated proactive support as embedded messages__ What are our next steps to explore the application of AI in documentation? How can we use a messaging framework to send highly relevant chunks of content to a user?
by Kristof van Tomme 7 years 10 months ago

Software Support and Artificial Intelligence - Part 4: Repeating Clippy’s mistakes with Walkthroughs

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables. Part 4: Repeating Clippy’s mistakes with Walkthroughs Learning from Clippy’s mistakes. How can we define proactive support? How can we avoid repeating Clippy’s mistakes?
by Kristof van Tomme 7 years 11 months ago

Software Support and Artificial Intelligence - Part 3: Clippy, misunderstood brilliance before its time

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables. __Part 3: Clippy, misunderstood brilliance before its time__ Microsoft’s Clippy was a great idea: sometimes it does pay off to give people advice even if they didn’t ask for it yet. So why did it fail?

Newsletter

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.

 

Subscribe