• Overview
    Key features
    • Observability
    • Auto-scaling
    • Multiframework
    • Security
    • Django
    • Next.js
    • Drupal
    • WordPress
    • Symfony
    • Magento
    • See all frameworks
    • PHP
    • Python
    • Node.js
    • Ruby
    • Java
    • Go
  • Industries
    • Consumer Goods
    • Media/Entertainment
    • Higher Education
    • Government
    • Ecommerce
  • 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
  • Login
  • Request a demo
  • Free Trial
Meet Upsun. The new, self-service, fully managed PaaS, powered by Platform.sh.Try it now

Platform.sh Documentation - The Next Generation

21 September, 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

Cover image

Platform.sh announces $140m series D round of funding

AboutSecurity and complianceTrust CenterCareersPressContact us
Thank you for subscribing!
Field required
Leader Winter 2023
System StatusPrivacyTerms of ServiceImpressumWCAG ComplianceAcceptable Use PolicyManage your cookie preferencesReport a security issue
© 2024 Platform.sh. All rights reserved.
Supported by Horizon 2020's SME Instrument - European Commission 🇪🇺