Publishing some words on a page seems trivial, except it’s surprising difficult to achieve great documentation.

The obvious things like good (on brand) design and how to host it are the easy decisions compared to the problems you inevitably run into publishing documentation.

This is why most sites don’t have good documentation or don’t have documentation at all.

• How will you update and maintain the documentation?
  • Will developers be the only one’s who can update it?
• Are users actually reading and getting help from the documentation?
  • How do you design the reading experience?
  • How do you know if it’s working?
• Our users are global, how do distribute the documentation?
  • Okay we can host words on a page, but what about globally and to millions of readers?
  • How do we host images and videos?

… and many more questions you might ask when building documentation.

Good documentation is readable, fast, and maintainable.

Readable — Most importantly good documentation is easy to read and consume for your end user. It’s actually helpful.

Fast — Documentation is mostly words, images, and sometimes videos on a page. If your documentation is slow and clunky it’s

Maintainable — if you can’t manage your own documentation, how will your users ever benefit from it? If it’s not up to date, accurate, and maintained, your users will never use it.

By the time you actually design your docs, build the site to host them, figure out how images and videos will work, decide on a publishing strategy, and then plan how you will collaborate with your team and keep your docs up to date, you realize that documentation is a full time job. Sometimes a full time team job.

You could hire a dedicated team to build and manage your documentation, or you could keep focusing on your business.

publish.dev is a Documentation Operating System. We call it Docs OS.

It allows you to spin up beautiful, fast, and optimally designed documentation in minutes, not months.

Better still, updating or creating new docs is easy. Just hit publish.

Documentation built on publish.dev is beautifully designed and fully customizable. We’ve spent years designing the best possible reading experience, customize it to fit your brand, product, and end users.

Our docs comes with state of the art Hosting, Caching, and Compute so that your documentation is always fast.

Updating is as easy as hitting publish. Instant publishing and site deploys.

Build docs with publish.dev. Visit publish.dev to request a demo or reach out to sales@publish.dev for full white glove service.