Skip to main content

Paulo Borges

I turn complex systems into clear, usable documentation,
and I can build the systems too.

Documentation Engineer ยท Software Developer ยท Rio de Janeiro, Brazil

What I Do

8+ years working at the intersection of software engineering and technical communication

โš™๏ธ
Software Engineering
  • Tech lead for 15-person team (real-time Kafka platform)
  • Event-driven microservices: WhatsApp, iFood, in-store channels
  • AI-assisted full-stack development (Python, PostgreSQL, Redpanda)
๐Ÿ—๏ธ
Documentation Engineering
  • 2 full platform migrations (Gatsby โ†’ Docusaurus โ†’ Antora)
  • 2,000+ config properties auto-generated from C++ source
  • 70% faster deployments via build pipeline optimisation
โœ๏ธ
Technical Writing
  • End-to-end Disaster Recovery docs (95% solo-authored)
  • GBAC security documentation from zero
  • Cross-functional coordination across engineering, PM, and CS

Impact at a Glance

Highlights from 8+ years across engineering and documentation roles

50K+
monthly doc readers
2,000+
config properties auto-generated
80%
reduction in manual doc overhead
70%
faster deployments (Kurrent)
12+
versioned product releases managed

Selected Work

Across documentation engineering, technical writing, and software development

Redpanda Shadowing: Disaster Recovery

95% solo-authored end-to-end DR guide. Participated in engineering design reviews, co-wrote PRDs and RFCs, then wrote the full user-facing technical guide across cloud and self-managed deployments.

Docs Writing
Read more โ†’

Docs Platform Automation

Built Python + tree-sitter tooling to parse a C++ codebase and auto-generate reference docs for 2,000+ configuration properties, eliminating ~80% of manual update overhead.

Docs Engineering

Kurrent: Astro/Starlight Migration

Diagnosed critical VuePress memory constraints; architected migration to Astro/Starlight. Achieved 70% build speedup and fixed 100+ broken links. Migration was in progress at time of company-wide layoff.

Docs Engineering

Order Processing Platform

Led a 15-person team building a real-time event-driven order ingestion system at one of Brazil's largest fuel retailers, aggregating WhatsApp, iFood, in-store, and web channels via Confluent Kafka.

Software Engineering

BID Soccer Notification System

End-to-end event-driven system built entirely with AI-assisted development: polls Brazilian soccer transfer registry (with CAPTCHA), deduplicates records, streams via Redpanda, sends real-time Telegram alerts.

Software Engineering

GBAC Security Documentation

Authored Group-Based Access Control documentation from scratch, covering concepts, configuration procedures for cloud and self-managed clusters, and reusable UI procedure partials.

Docs Writing
Read more โ†’

Writing Samples

Original documentation authored for Redpanda, reproduced here as portfolio samples

Writing Sample: Disaster Recovery
Shadowing Overview
Shadowing is a disaster recovery feature that continuously replicates a source cluster's data and state to a shadow cluster, so that during an unplanned outage, you can quickly restore your operations on that shadow cluster.
Read full documentation โ†’
Writing Sample: Security
Group-Based Access Control
Group-Based Access Control (GBAC) lets you assign roles to groups of users instead of individual accounts. When you assign a role to a group, all members of that group inherit the permissions defined by that role.
Read full documentation โ†’

Tech Stack

Tools and technologies I work with regularly

Docs & Content

AsciiDocMarkdown / MDXAntoraDocusaurusAstro / StarlightVuePressSwagger / OpenAPI

Platforms & Tooling

GitHub ActionsNetlifyCloudflareAlgoliaKapa.aiClaude Code MCPPostHogDatadog

Software

PythonJavaKafka / RedpandaFastAPIAWSDockerPostgreSQLNode.js

Let's Connect

Open to documentation engineering and software development opportunities