Articles

What information will help you outline what content and functionality should be in your portal? When should you integrate with 3rd party systems? Why is information architecture a vital base for your DevPortal?

What is CI/CD development? How does CI/CD relate to docs-as-code? How can I write and maintain human-readable documentation while incorporating an automated testing framework to my review process? We provide an infographic and a description that illustrates our take on how CI/CD documentation, DocOps, and the Docs-as-code integrate.

When you pay attention to accessibility the overall user experience will be better and your users will be more likely to engage with your devportal. This article collects various explanations, tricks and tools that enable inclusivity in the broad sense.

In this article, we outline the basic principles of Docs-as-Code, some tools for writing and running automated tests against your documentation, and how these workflows can help improve the quality of your documentation. Using VS Code, git workflows, and automated documentation quality tests with Vale, we’ll show you how these tools can be used in concert in your DocOps setup.

In our Devportal Design Guide series, you will read about common design patterns, get an insight into our project work related experiences, and learn how we tackle the design of a developer portal user interface. Part 5: Further visual solutions to improve the user experience

In our Devportal Design Guide series, you will read about common design patterns, get an insight into our project work related experiences, and learn how we tackle the design of a developer portal user interface. Part 4: Basic graphical elements that support functionality