API and developer documentation
I own the documentation lifecycle. At Cloudflare, I built and tested API request examples in Postman, wrote product concepts and troubleshooting guides, and maintained content in a docs-as-code repository.
Technical Writer • API documentation • Networking & security • Docs-as-code
I make complex technical products easier to understand and use.
I write and maintain developer documentation for complex products, including API examples and troubleshooting guides in a docs-as-code environment. I also build AI-assisted workflows that speed up research and large documentation changes. I make the final decisions and remain responsible for what gets published.
What set him apart was how he thought about the work around the writing.
Where I add value
Documentation that helps developers and customers get unstuck.
Information architecture and self-service
I use support cases and customer journeys to find where users get stuck, then restructure documentation around the decisions and symptoms they bring to it. At Cloudflare, that meant using 753 support cases to redesign a troubleshooting set and reorganizing more than 400 pages after a dashboard redesign.
AI-assisted documentation workflows
I build reusable workflows for documentation research, large migrations, and review triage. They handle repetitive work. The writer checks sources and scope before editing the final copy.
Impact, by the numbers
Case studies
Documentation systems, operational tooling, and support-driven workflows, with measurable outcomes.
753 support cases analyzed
Used 753 support cases to redesign a self-service troubleshooting system
Analyzed support cases in the product area's largest support category and built a four-guide troubleshooting suite for enterprise networking products, reaching thousands of views in the first three months.
Read the full case study →Research reduced from days to ~60 minutes
Built an 80+ component AI workflow system that cut research from days to about an hour
Designed reusable AI-assisted workflows for research, auditing, migration planning, review triage, documentation quality checks, and structured drafting. The result was not just faster writing, but shared infrastructure for repeatable documentation work across multiple teams.
Read the full case study →695 files in 3 days
Automated a 695-file cross-product migration and completed it in three days
Reduced a projected multi-week migration into a 3-day operational workflow by automating documentation updates across 695 files, 349 URL mappings, and hundreds of supporting assets.
Read the full case study →Weekly production digest
Turned scattered GitHub activity into a shared operating view with automated triage
Built automated reporting workflows that surfaced stalled pull requests, tracked queue state, and improved review prioritization for the documentation team.
Read the full case study →Practical AI work
Working tools, built around real problems
I use AI to turn real operational problems into working tools. These projects demonstrate product judgment, workflow design, model orchestration, iteration, and the ability to ship—not just prompt-writing.
Job Hunt Automation
Local and cloud models, source aggregation, fit evaluation, ATS scoring, and application-state tracking in one job-search workflow.
Metro Agora
Public transport data, API proxying, and a live installable web application for Lisbon Metro arrivals.
Fogos Firewatch
Scheduled wildfire monitoring, distance and wind-based risk evaluation, and targeted notifications.
In their words
Recommendations
The consistent theme in peer feedback: my value is not only the documentation I publish, but the systems, workflows, and judgment I bring to the work around documentation.
He's the kind of writer who is constantly pushing the envelope for what a technical writer can do. He built a full AI toolkit — agents, skills, custom commands — that connected MCP servers, documentation sources, and GitHub into workflows that let writers move through research, drafting, and publishing dramatically faster. Proactive, reliable, and completely unfazed by ambiguity. I'd work with Márcio again without hesitation.
He's proactive — for every feature I built, he asked about documentation needs before it even crossed my mind. He's organized, keeping careful track of release dates, and very good at quickly learning new tech all across our product suite. Márcio also invented workflows to use LLMs for large docs refactors that would have been tedious and error prone by hand. And to top it all off: he's one of the kindest people I've worked with — you want him on your team!
Featured writing
Thinking behind the work
Selected posts on technical writing, AI workflows, and documentation systems.
You already have docs, you just don't know it yet
If your company's knowledge is scattered across multiple places and nobody owns it, sooner or later that knowledge debt will cost you money. Here's why you should hire a tech writer, and what a tech writer even is.
Measuring my search, not defining myself by it
After months of applying to jobs and waiting for answers that might not come, you can start measuring your self-worth by the number of replies you (don't) get.
An untested API example is just a guess
A curl command can be perfect and still be a lie. Clean syntax, the right endpoint, every parameter where the spec says it should be, a response body with all the fields you'd expect. None of that tells you the request actually runs.
About
From tech journalism to developer docs
For five years at Cloudflare I owned the documentation for Cloudflare WAN, Magic Transit, Multi-Cloud Networking, Network Flow and Network Interconnect, and earlier covered Cloudflare Network Firewall, 1.1.1.1, the WARP client, Zaraz and Email Routing. I tested API examples against live OpenAPI endpoints, rebuilt the troubleshooting docs from support data, and reorganized more than 400 pages after a dashboard redesign.
Most of that work is public. Between 2021 and 2026 I merged 1,216 pull requests into Cloudflare's documentation repository, from single-line corrections to 390-file migrations.
Before Cloudflare I spent seven years at Exame Informática. I joined as a technology journalist, testing hardware and software, and later became editor of the how-to section. I'd started out as a journalist at Bit.
I also build AI tooling for my own work. At Cloudflare it cut research from 2–3 days to about an hour, and several teams adopted it. I make the final call on everything that gets published.
Contact
Looking for a technical writer who can own complex documentation from research through maintenance?
I'm looking for technical writing roles involving API or developer documentation, docs-as-code, or complex technical products. I bring five years of Cloudflare experience and practical AI skills that make research, review, and maintenance faster.