# Paulo Duarte — Technical Writing Portfolio

> Production-grade API documentation samples by Paulo Duarte, Senior Technical
> Writer specialising in API docs, developer experience, and documentation-as-code.
> Each document follows a structure of: conceptual overview → when not to use →
> prerequisites → step-by-step guide → complete runnable example → reference tables
> → troubleshooting. All code samples are Python 3.9+ and have been manually
> validated. Last portfolio update: 2026-05-06.

## Documents

- [Implementing Streaming Responses with the Claude API](https://paulogpd.com.br/streaming-claude.html): Covers Server-Sent Events (SSE) conceptual model, when not to stream (batch, short responses, full-output pipelines), synchronous and async Python with the Anthropic SDK, curl examples, SSE event-type reference table, SDK helper methods, and 9 troubleshooting scenarios. Written against Anthropic API 2023-06-01 and claude-sonnet-4-6.

- [Personal Access Tokens vs GitHub Apps](https://paulogpd.com.br/github-pats-vs-apps.html): Decision guide for GitHub API authentication covering fine-grained PATs, classic PATs, and GitHub App installation tokens. Includes JWT generation, installation token exchange, rate-limit comparison, governance trade-offs, and two complete runnable Python scripts. Written against GitHub REST API v2022-11-28.

- [Stripe Webhooks: From Setup to Production](https://paulogpd.com.br/stripe-webhooks.html): End-to-end webhook guide covering event-push model, Flask endpoint setup, Stripe CLI local forwarding, signature verification with construct_event, idempotency via a thread-safe per-request database connection (SQLite or PostgreSQL), per-type event dispatch with named handler functions, --backfill reconciliation mode using auto_paging_iter, production checklist, and 7 troubleshooting scenarios. Written against Stripe API 2024-06-20.

## About the Author

Paulo Duarte is a Senior Technical Writer based in Porto Alegre, Brazil, with
specialisations in API documentation, developer experience, and documentation-as-code
toolchains. He holds an IELTS 8.5 and has 11+ years of technical translation
experience. Portfolio: https://paulogpd.com.br