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 Dezső Biczó 5 years 2 months ago

Drupal 9: Automated Deprecated Code Removal - A Proof of Concept

We would like to introduce a new tool called _Rector_ that could speed up an upgrade process and can reduce upgrade costs. We run a proof of concept for the possible use cases in which Rector can be beneficial for Drupal developers - including but not limited to the automated update to Drupal 9.
by 6 years 11 months ago

Treat docs like code

On the Write The Docs London meetup in January speakers from leading Git code repositories talked about how their teams dogfood their own tools to do their documentation. _Version the Docs_ covered Bitbucket and GitLab, but we missed a GitHub presentation. To fill this gap, we interviewed Anne Gentle about GitHub, treating docs like code, and community contributions to documentation.
by Laura Vass 7 years 1 month ago

API Documentation at WTD NA 2017

The annual North-American Write The Docs conference this year featured 2 API documentation redo presentations: 1. Lyzi Diamond described Mapbox (formerly a part of Development Seed) documentation automagic in detail, 2. Sarah Hersh talked about the journey that NPR One undertook towards a new task-based approach for their API's developer documentation. In this post we aim to give you an account of these presentations.
by 7 years 2 months ago

Documenting web APIs with the Swagger / OpenAPI specification in Drupal

As part of our work to make Drupal 8 the leading CMS for developer portals, we are implementing a mechanism to import the OpenAPI (formerly known as Swagger) specification format. This is a crucial feature not only for dedicated developer portals, but also for all Drupal sites that are exposing an API. Now that it has become much easier to create a RESTful API service in Drupal 8, the next step is to make it more straightforward to create its API reference documentation. That is why we think our work will be useful for site builders, and not just for technical writers and API product owners.
by Dezső Biczó 7 years 3 months ago

Web APIs in Drupal: success takes more than an endpoint

Web APIs are not just useful when making headless sites in Drupal: large Drupal sites often hold valuable information that could also be useful outside the site's context. Media companies might want to expose historical media content, community sites could show data about their community activities, e-commerce sites tend to open an API for their affiliates and partners. While it is possible to use Drupal 7 and Drupal 8 as an API backend, a lot of functionalities that describe a mature API service do not come out of the box. In this post we will explain what key concepts you have to keep in mind when designing an API service, why they are important and how APIgee Edge can make it easier to build a full-featured API webservice in Drupal successfully.
by Kristof van Tomme 7 years 5 months ago

Using Graph Databases in Popular Open Source CMSs

In a talk we did at FOSDEM ‘17, Tamás Demeter-Haludka and I discuss __potential application areas of graph databases in existing open source CMSs like Drupal__.

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