• Overview
    • Django
    • Next.js
    • Drupal
    • WordPress
    • Symfony
    • Magento
    • See all frameworks
    • Observability
    • Auto-scaling
    • 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

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

Related Content

It’s time for version 19: All new upgrades for our API server

It’s time for version 19: All new upgrades for our API server

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