PlatformOS Developer Portal | API The Docs Virtual 2021 | Showcase Your Devportal
Diana Lakatos & Adam Broadway
For the 2021 autumn season of API The Docs, 16 DevPortal Awards nominee teams share the highlights of their devportal journey. Each team will introduce the best features of their sites, share their experiences, talk about their future plans, and participate in Q&A sessions.
About the session:
Date: 20 October, 2021
Diana Lakatos (Director of Documentation) and Adam Broadway (CEO) will introduce the platformOS developer portal. The site was nominated in the "Best Developer Portal for Alternatives to REST-APIs", "Best Editorial Experience in a Devportal", "Best Accessible Devportal", and "Best Onboarding" categories for the Devportal Awards 2021.
About the portal:
"The platformOS Developer Portal provides onboarding, conceptual information, tutorials, examples, API references, use cases, and best practices to developers building their apps or sites on platformOS. Following the docs as code approach, it is built for iterations and collaboration — it swiftly adapts to our users’ needs as we involve them in all phases of our editorial workflow."
"The platformOS Developer Portal provides comprehensive onboarding journeys to the three main segments of our target audience:
- Non-technical users:
The 1-Click install route takes you through registering on the Partner Portal to creating a demo site and installing the blog module on it by only clicking through a setup wizard.
- Semi-technical users:
The Sandbox route lets you create a sandbox to experiment in by cloning a demo site from our GitHub repository. Semi-technical users also have the option to go through our Hello, World! Guide. Hello, World! is the first part of our Get Started guide, that will teach you how to set up your development environment, create a simple site, make a small change on the home page, and deploy it. This is to make sure you have everything you need and everything works.
- Technical users:
Build a ToDo List App is the second part of our Get Started guide. It walks you through the steps of creating a ToDo List app on platformOS from setting up your development environment to deploying and testing your finished app. It explains basic concepts, main building blocks, and the logic behind platformOS, while also giving you some recommendations on the workflow.
We provide two options for users to start building their platformOS sites: start from a pre-made template or from scratch based on our detailed tutorials.
We deeply care for accessibility. Right from the design phase, we use Figma’s Able accessibility plugin. We regularly test for accessibility with various tools and ensure that the site complies with all accessibility requirements as proven by its perfect scores in Google Lighthouse, Wave, and AChecker. Besides the technical requirements for accessibility, we think inclusive and accessible language is just as important. This is why we have added accessibility guidelines to our Style Guide and regularly review our content for inclusiveness.
Our workflow is unique in its flexibility to support any type of participant: internal developers, writers, editors, partners, or external contributors. We implemented a complete docs as code workflow on GitHub and took it even further by incorporating issue tracking and project management. We implemented continuous integrations and continuous deployment with automated testing. Our editorial workflow ensures that contribution works the same way for everyone, and we support our contributors with a Contributor Guide, a Style Guide, and Markdown templates for each type of content."
