Announcement: New Documentation Site Design

Last week, we applied the new design to our documentation site. Besides having a more polished look and feel, the new design incorporates UX improvements based on your feedback. Thank you! The redesign is not final yet, we are still working on specific areas of the site (e.g. Release notes, feedback block).

As part of the restructuring of the Tutorials section based on our recent UX research, we ordered Tutorials into larger topics, that act as visual separators among Tutorial categories. This is the first step in improving tutorials: We will move Best Practices to their own section next, and then start editing content to follow the more concept-focused, more narrative approach we shared with you in last week’s status report. 

Documentation

Content production

• NEW API Reference main category landing pages: API Reference, REST API
• IN REVIEW Using the GeoJSON format for Geolocation (new rounds of improvements based on reviewers’ feedback)
• IN PROGRESS Article: Building Our Documentation Site on Platform OS — Part 4: Implementation
• PLANNED Best Practices: dates, daylight saving times, locations 

Improvements, fixes

• FIXED Search now searches through all the docs, even those that were unsearchable before
• IMPROVED Tutorial categories now link to the first topic in the category
• PLANNED Update JSONs with remote docs in the background
• PLANNED fix The icon overlaps the text

UX

Research

• Onboarding strategy: We collected the persona related onboarding routes and as a next step our goal is to collect information from experienced pOS users and identify the key aha moments you had while using the platform. Additionally, we’d like to do some follow ups with new users and identify the key questions during the learning process.  We’ll use the research information to fine-tune our onboarding experience.

Design and Development

• NEW Sold modules and Purchased modules screens: Find it under your partner account!
• NEW In advanced payments for modules — Module subscriptions: The first payment is calculated for the time period from the day of purchase to the end of the month. After the first payment, you'll be charged upfront on the first day of each month with the full monthly price.
• NEW Module Payment: modify confirmation pop-up text
• NEW Modules Detail page: Dropdown for instance selection should be empty before usage
• IN PROGRESS Report about module purchase: downloadable CSV
• IN PROGRESS Notification emails after module usage: installation, new version, and update
• PLANNED Show versions and release notes on the module detail page