Skip to main content

My work at Ably

I joined Ably in August 2023 as a Developer Educator and Docs Engineer, working on their realtime messaging platform. My focus is making complex WebSocket and database sync concepts accessible to developers.

What I do at Ably​

Most of my work centers around Ably's realtime platform - helping developers understand how to build apps with WebSockets, Server-Sent Events, and their newer database sync features.

Key areas of contribution​

Re-engineering the docs site: Textile → Next.js + TypeScript + React​

Ably's docs site was migrated off a legacy Textile-based content system onto a modern Next.js application (TypeScript + React, with MDX for content). I contributed directly to that migration by converting high-traffic reference pages from Textile into MDX and wiring them into the new page-based routing.

Ably docs architecture Ably docs component structure

Two of the larger conversions are merged upstream:

  • ably/docs#2911: Converts the REST API reference page to MDX. 2,027 lines added, 1,512 deleted (the old content/api/rest-api.textile removed, the new src/pages/docs/api/rest-api.mdx added).
  • ably/docs#2913: Converts the SSE reference page to MDX. Moved content/api/sse.textile into src/pages/docs/api/sse.mdx so the page lives alongside the rest of the React app.

The conversions aren't just copy-paste. Textile callouts, inline language tabs, and variable interpolations had to be rewritten as MDX components so the rendered output stayed consistent with the new design system. After conversion the pages can import React components directly, which is how the interactive code samples and language switchers now work.

Server-sent events documentation​

I completely rewrote Ably's SSE documentation, converting it from basic markdown to an interactive guide with working examples and troubleshooting steps. The MDX conversion (#2913) landed as part of this work.

Ably SSE documentation Ably SSE documentation - troubleshooting

Webhooks and security​

Rewrote the webhook security documentation to be more practical, with step-by-step validation examples and common security mistakes.

Ably webhook security documentation

Pub/Sub and Developer onboarding​

Rebuilt the developer onboarding documentation to be more accessible while maintaining technical depth. Recent work includes intro copy and USP sections across Pub/Sub, Spaces, Chat, LiveSync, and LiveObjects docs.

Ably Pub/Sub documentation

Troubleshooting and support content​

Produced troubleshooting guides and diagnostic content covering common developer issues, including generating HAR files (#2984) and documenting service disruption behaviour (#2818).

Ably troubleshooting documentation

Merged pull requests​

Selected PRs that landed in ably/docs:

PRSummaryMerged
#2911Converts REST API reference to MDX (part of the Textile → Next.js/TypeScript/React migration)2025-11-07
#2913Converts SSE reference to MDX2025-11-07
#2984Self-service HAR file guide for connection troubleshooting2025-12-01
#2818Service disruptions documentation and developer guarantees2025-09-18

Full history: all merged PRs by me on ably/docs.

Tools and approach​

ToolPurpose
MDX + DocusaurusFor interactive documentation
GitHub ActionsFor automated testing of code samples
LinearFor project tracking with the engineering team
NotionFor content planning and strategy docs

The goal is always the same: can a developer copy the code, run it, and have it work? If not, the documentation isn't done.