• Overview
    Frameworks
    • Drupal
    • WordPress
    • Symfony
    • Magento
    • See all frameworks
    Features
    • Observability
    • Auto-scaling
    Solutions
    • Marketing Teams
    • Retail
    • Higher Education
  • Pricing
  • Featured articles
    • Switching to Platform.sh can help IT/DevOps organizations drive 219% ROI
    • Organizations, the ultimate way to manage your users and projects
  • Support
  • Docs
  • Contact
  • Login
  • Free Trial
Blog

Platform.sh Documentation - The Next Generation

September 21, 2016
Larry Garfield
Larry Garfield
Director of Developer Experience

Platform.sh is a unique and powerful development tool. However, because it’s so unlike any other development platform it’s not always immediately obvious just what it can do. A great development platform deserves great documentation.

For that reason, we’re proud to release a major overhaul of our public documentation. We’ve completely redesigned the information architecture (IA) to make it easier to navigate and easier to scan. We’ve also collapsed the multiple separate “books” into a single hierarchy to make at-a-glance navigation easier.

The new IA was based in a part on an online card-sort exercise we ran with several of our users a few weeks back (thank you to those that participated!) and in part from analyzing our Google Analytics logs. Nearly all of our most trafficked pages are now accessible in a single click (where some were 4 layers deep previously!), and several nearly-unused pages have been removed.

We’ve also added a new introduction section to provide a “big picture” view of how Platform.sh works: our general philosophy, the basic building blocks, and the build and deploy process.

The documentation itself is built with GitBook, a Node.js-based static documentation generator. It is, of course, hosted on Platform.sh itself. You can see exactly how it’s setup in the public GitHub repository. Oh, you didn’t know that you can host Platform.sh projects on GitHub with transparent integration and an automatic environment created for every pull request? See the docs for how.

In fact, we’d encourage you to have a look at the repository even if you’re not curious. This overhaul isn’t the last we’ll be working on the docs. Good documentation is an ongoing process, and we welcome your feedback. In fact, we welcome your Pull Requests, too. Have a look at our contributing guidelines and if you find errors, oversights, or simply something that isn’t clear let us know either with a Pull Request or simply file an issue.

Happy deploying!

Get the latest Platform.sh news and resources
Subscribe

Related Content

PHP 8.2 lays new ground on Platform.sh

PHP 8.2 lays new ground on Platform.sh

Company
AboutSecurity and complianceTrust CenterBoard and investorsCareersPressContact us
System StatusPrivacyTerms of ServiceImpressumWCAG ComplianceManage your cookie preferencesReport a security issue
© 2022 Platform.sh. All rights reserved.
Supported by Horizon 2020's SME Instrument - European Commission 🇪🇺