DeveloperHub.io blog

Editor, transplanted.

Editor, transplanted.

How we replaced the heart of DeveloperHub, the editor and the way every page is stored, with zero downtime and nothing for our customers to do

A new way to write docs

A new way to write docs

We rebuilt the DeveloperHub editor from the ground up. Here is what is new, and why it makes writing and maintaining your documentation noticeably better.

The Real Cost of a High Learning Curve: Why DeveloperHub Wins for Cross-Functional Documentation

The Real Cost of a High Learning Curve: Why DeveloperHub Wins for Cross-Functional Documentation

A high learning curve is not just a personal inconvenience. For growing teams, it becomes an organizational tax paid in time, misalignment, and slow knowledge flow.

Meet Your New OpenAPI Editor: A Modern Alternative to Swagger Editor

Meet Your New OpenAPI Editor: A Modern Alternative to Swagger Editor

For years, editor.swagger.io was the place everyone went to sketch out an OpenAPI definition. It was familiar, convenient, and good enough for its time. The problem is simple though: the specification has moved on, tooling expectations have moved on, and that classic editor has not kept pace. If

XML Modelling in OpenAPI 3.2: A Quiet but Important Upgrade for Enterprise Teams

XML Modelling in OpenAPI 3.2: A Quiet but Important Upgrade for Enterprise Teams

OpenAPI 3.2 modernises XML support with richer modelling, proper attribute handling, and nested structures. It removes old workarounds and gives enterprise teams clearer, more accurate ways to define their XML based APIs.

Deprecations, Defaults, and Details: The Subtle Tweaks You Might Miss in OpenAPI 3.2

Deprecations, Defaults, and Details: The Subtle Tweaks You Might Miss in OpenAPI 3.2

OpenAPI 3.2 brings subtle refinements that make specs cleaner and more predictable, from improved deprecation handling to clarified defaults, schema rules, and examples.

The New QUERY Method in OpenAPI 3.2: A Small Addition That Clears Up a Big Ambiguity

The New QUERY Method in OpenAPI 3.2: A Small Addition That Clears Up a Big Ambiguity

OpenAPI 3.2 adds support for the new QUERY method — a read-only operation that allows a request body. It’s designed for search and filtering endpoints that don’t fit neatly into GET or POST.

Structured Tags in OpenAPI 3.2: Organising APIs the Way They Deserve

Structured Tags in OpenAPI 3.2: Organising APIs the Way They Deserve

OpenAPI 3.2 introduces structured tags, allowing APIs to organize endpoints into nested categories for clearer, more maintainable documentation.

Event streaming in OpenAPI 3.2: What changed and why it matters

Event streaming in OpenAPI 3.2: What changed and why it matters

OpenAPI 3.2 brings first‑class event streaming with sequential media types and an itemSchema for each event. Document SSE or JSONL streams clearly—ideal for LLMs that stream tokens, optional summaries, and a deterministic “[DONE]” sentinel to end the stream.

What’s Changing in OpenAPI 3.2 and Why You Should Care

What’s Changing in OpenAPI 3.2 and Why You Should Care

See what's new in OpenAPI v3.2. Better structure, better auth support, better file and stream handling - no breaking changes.

7 must-have features in a documentation editor in 2025

Selecting the right documentation editor is essential for technical writers. Look for features like advanced formatting, customizable blocks, version control, and powerful search functionality. These tools enhance collaboration and ensure your documentation is clear, accessible, and easy to manage.

Dark Theme - CSS Migration

Dark Theme - CSS Migration

Dark theme is out now! Let those eyes rest.

3 Essential Types of Documentation for Tech Businesses

3 Essential Types of Documentation for Tech Businesses

Product documentation is a type of documentation that provides information about the features and functionality of a product

DeveloperHub in 2021

Company Updates

DeveloperHub in 2021

We really believe that we built the best customer-facing documentation platform out there - unparalleled to any other competitor.

Case Study: Why should you move from WordPress to a modern documentation system

Case Study: Why should you move from WordPress to a modern documentation system

Move from static CMS to DeveloperHub to boost your team's efficiency by 3X.

Establishing a Review Process

Establishing a Review Process

One of the most interesting, and difficult, aspects of technical writing is the synthesis of subject matter expertise with the needs of various users. You must simultaneously be the plain-language advocate for the novice user while also ensuring that savvy developers can get everything they need from the documentation. It’

What's new in OpenAPI 3.0?

What's new in OpenAPI 3.0?

OAS 3 has simplified structure, new reusable features, extended support for schema object and more

2 years, 1% done

Company Updates

2 years, 1% done

We have made so many relationships with our customers, and never have we better understood what you need more. The old ways of documentation are long gone, we are changing it and we are really just getting started.

Using your own Custom Font

Using your own Custom Font

The four steps needed to get your brand's font on your documentation portal.

Are you ready to move from static to dynamic documentation?

Are you ready to move from static to dynamic documentation?

Managed documentation services enable users to focus on the writing process itself without bothering about the documentation build and hosting processes.

10 Tips for Structuring your Product Documentation

Documentation Featured

10 Tips for Structuring your Product Documentation

Experiences of a developer turned technical writer

Draft — Publish When Ready

Draft — Publish When Ready

We are introducing draft mode to all our users at DeveloperHub.io. Draft mode brings more power to your editors, the flexibility to write freely, and the ability to publish at the right time.