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.
Categories
by 10 years 6 months ago
An overview of context-sensitive and embedded help formats
When we tried to learn more about the different types of contextual and embedded help, we found that the definitions, solutions and use cases were scattered and ambiguous. This post is an attempt at collecting and presenting the information from our research in an easier to understand format, so that you can get an overview of your options before you decide on an implementation.
API Documentation week in London, 2-4 March
The first week of March I will be in London for 3 events related to documentation, APIs and Drupal Developer portals. If you are working on an API documentation project, you should not miss this opportunity:
Publishing a code sample book from Stackoverflow to LeanPub using Drupal and GitLab
In this blogpost we want to share how Bruno Lowagie (the original developer of iText) designed a workflow that allows him to publish questions and answers from Stackoverflow on the iText Drupal site and then export them to LeanPub (utilizing a custom Drupal module).
Walkthroughs and Instructional Design
There is no way to tell if a new visitor to your website or web application will be a total novice. At least some of them will have prior experience. When you force somebody like that through a Walkthrough, they might feel resentful and not read any of the offered information. Even if some of the Walkthrough steps would have introduced new and helpful information.
by 10 years 7 months ago
Being Content Writing Content
I noticed many similarities between hosting guests and writing blog posts. Think of your favourite site for a moment. Why do you like using it? Why do you keep going back? If two sites offered the same, which one would you prefer? Words such as user-friendly, well-organized, to-the-point, better service might come to mind. In this post I will focus on bloggers. How can you address an audience? How can you write engaging content and earn regular visitors? Some tips and tricks I’ve stumbled upon so far.
by 10 years 7 months ago
PDF is dead; long live PDF! New standards with new applications - PDF in Drupal part 2
It’s strange but true: seven years after the PDF reference was published as an ISO standard (ISO-32000-1), there are still developers who think that the Portable Document Format is a closed document format owned by Adobe. PDF is often perceived as a strange, impenetrable document format. It’s high time we bury that idea and take a look at what’s going on in the world of PDF today...