Field notes on developer tooling, APIs, infrastructure, data systems, and the documentation that makes them usable.https://joanayebola.vercel.app/enhttps://joanayebola.vercel.app/blog/agent-memory-patterns/https://joanayebola.vercel.app/blog/agent-memory-patterns/Build a practical memory layer for an AI agent, choose where each kind of memory lives, and design retrieval and forgetting that you can trust.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialai-agentsmemoryvector-searchsystem-designpythonhttps://joanayebola.vercel.app/blog/api-keys-to-scoped-tokens/https://joanayebola.vercel.app/blog/api-keys-to-scoped-tokens/Migrate a public API from all-powerful API keys to scoped, expiring tokens: design the scopes, run both systems in parallel, and deprecate keys without breaking clients.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformsmigration-guideapi-securityauthenticationoauthmigrationapi-designhttps://joanayebola.vercel.app/blog/api-rate-limiting-design/https://joanayebola.vercel.app/blog/api-rate-limiting-design/Design rate limits that protect your API without punishing good clients: fair quotas, honest headers, and 429 responses developers can act on.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformstutorialrate-limitingapi-designreliabilitydeveloper-experiencehttps://joanayebola.vercel.app/blog/api-reference-design/https://joanayebola.vercel.app/blog/api-reference-design/An API reference is read under pressure, mid-debug. Design it that way: auth before endpoints, a worked example per operation, and errors documented like features.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxtutorialapi-documentationapi-referencedeveloper-experiencetechnical-writinghttps://joanayebola.vercel.app/blog/api-versioning-strategies/https://joanayebola.vercel.app/blog/api-versioning-strategies/Compare URL, header, and media-type versioning on real tradeoffs, and design a sunset policy that retires old versions without breaking clients.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformscomparisonapi-versioningapi-designrestdeveloper-experiencehttps://joanayebola.vercel.app/blog/bigquery-partitioning-clustering/https://joanayebola.vercel.app/blog/bigquery-partitioning-clustering/Partition and cluster BigQuery tables with intent: how pruning actually works, where each feature stops helping, and the decisions that are painful to reverse later.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringtutorialbigquerydata-warehousingcost-optimizationsqlhttps://joanayebola.vercel.app/blog/changelog-writing/https://joanayebola.vercel.app/blog/changelog-writing/Why the changelog is product writing, not a commit digest, and how to write entries that users actually read and act on.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxopinionchangelogsproduct-writingrelease-notesdeveloper-experiencehttps://joanayebola.vercel.app/blog/chunking-strategies-embeddings/https://joanayebola.vercel.app/blog/chunking-strategies-embeddings/Compare fixed-size, recursive, semantic, and structure-aware chunking so you can choose a strategy that improves retrieval instead of quietly breaking it.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingcomparisonembeddingsragchunkingvector-searchretrievalhttps://joanayebola.vercel.app/blog/ci-pipeline-caching/https://joanayebola.vercel.app/blog/ci-pipeline-caching/Cut CI time with dependency and build caching that actually invalidates correctly, matrix builds that parallelise honestly, and a quarantine lane for flaky tests.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialci-cdgithub-actionscachingtestinghttps://joanayebola.vercel.app/blog/cursor-pagination-api-design/https://joanayebola.vercel.app/blog/cursor-pagination-api-design/Implement cursor pagination that stays correct under inserts and deletes, with stable ordering, opaque tokens, and honest handling of filters.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformstutorialpaginationapi-designdatabasesresthttps://joanayebola.vercel.app/blog/dagster-vs-airflow/https://joanayebola.vercel.app/blog/dagster-vs-airflow/Dagster and Airflow compared on assets, sensors, partitions, backfills, retries, and observability, so you can choose the right core for a new platform.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringcomparisondagsterairflowdata-orchestrationdata-engineeringhttps://joanayebola.vercel.app/blog/data-quality-great-expectations/https://joanayebola.vercel.app/blog/data-quality-great-expectations/Build a working data quality gate with Great Expectations: define an Expectation Suite, run it as a Checkpoint, store the results, and fail CI on bad data.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringtutorialdata-qualitygreat-expectationsdata-engineeringcipythonhttps://joanayebola.vercel.app/blog/dbt-incremental-models/https://joanayebola.vercel.app/blog/dbt-incremental-models/Choose the right dbt incremental strategy, handle late-arriving data with lookback windows, and build the full-refresh habits that keep incremental models trustworthy.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringtutorialdbtincremental-modelsdata-modelinganalytics-engineeringhttps://joanayebola.vercel.app/blog/dbt-tests-data-contracts/https://joanayebola.vercel.app/blog/dbt-tests-data-contracts/Layer dbt generic, singular, and unit tests with enforced data contracts so upstream schema and logic changes fail in CI, not in a stakeholder's dashboard.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringtutorialdbtdata-qualitydata-contractsanalytics-engineeringhttps://joanayebola.vercel.app/blog/debezium-cdc-postgres/https://joanayebola.vercel.app/blog/debezium-cdc-postgres/Stand up Debezium on Postgres logical decoding, protect the replication slot, and write a consumer that handles snapshots, deletes, and schema changes without losing rows.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringtutorialdebeziumcdcpostgreskafka-connecthttps://joanayebola.vercel.app/blog/developer-onboarding-audit/https://joanayebola.vercel.app/blog/developer-onboarding-audit/A repeatable audit method for the developer onboarding funnel, with a scoring rubric and a clearly labelled illustrative walkthrough.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxdocs-teardownonboardingdeveloper-experiencedocumentation-auditapihttps://joanayebola.vercel.app/blog/diataxis-applied/https://joanayebola.vercel.app/blog/diataxis-applied/A field guide to applying the Diátaxis framework incrementally: audit what you have, split the pages that do two jobs, and move content in slices readers never notice.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxtutorialdiataxisinformation-architecturedocumentationtechnical-writinghttps://joanayebola.vercel.app/blog/docker-multistage-builds/https://joanayebola.vercel.app/blog/docker-multistage-builds/Learn multi-stage Docker builds for Node and Python with cache mounts, slim runtime images, non-root users, and digest pinning to cut bloat and build risk.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialdockernodejspythoncontainersdevopshttps://joanayebola.vercel.app/blog/docs-as-code-ci/https://joanayebola.vercel.app/blog/docs-as-code-ci/Wire documentation into CI so quality is enforced, not hoped for: prose linting that respects writers, link checking without false alarms, and previews on every pull request.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxtutorialdocs-as-codeci-cddocumentationvaledeveloper-experiencehttps://joanayebola.vercel.app/blog/error-message-writing/https://joanayebola.vercel.app/blog/error-message-writing/A practical method for writing error messages that name the problem, state the cause, and hand the user a fix they can actually perform.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxtutorialerror-messagesux-writingdocumentationapi-designhttps://joanayebola.vercel.app/blog/function-calling-error-handling/https://joanayebola.vercel.app/blog/function-calling-error-handling/Build a validation, retry, and repair layer for LLM function calling that rejects bad arguments, returns useful errors, and protects side effects.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialfunction-callingtypescriptzodjson-schemallm-tool-usehttps://joanayebola.vercel.app/blog/grafana-dashboards/https://joanayebola.vercel.app/blog/grafana-dashboards/Design Grafana dashboards around the questions operators actually ask: symptom-first layout, RED and USE panels, honest thresholds, and variables that narrow scope.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialgrafanadashboardsprometheusobservabilityhttps://joanayebola.vercel.app/blog/grpc-vs-rest-vs-graphql/https://joanayebola.vercel.app/blog/grpc-vs-rest-vs-graphql/The same internal service built three ways: compare gRPC, REST, and GraphQL on contracts, payloads, streaming, and operability, then decide with a framework you can reuse.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformscomparisongrpcrestgraphqlapi-designmicroserviceshttps://joanayebola.vercel.app/blog/incident-runbooks/https://joanayebola.vercel.app/blog/incident-runbooks/Write runbooks an exhausted engineer can execute at 3 a.m.: symptom-based triggers, numbered verifiable steps, explicit stop conditions, and a maintenance loop.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilityopinionincident-responserunbookson-callsrehttps://joanayebola.vercel.app/blog/kafka-delivery-semantics/https://joanayebola.vercel.app/blog/kafka-delivery-semantics/At-most-once, at-least-once, and exactly-once in Kafka, precisely: which configurations deliver which guarantee, where exactly-once stops, and what to build instead.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringtutorialkafkastreamingdistributed-systemsexactly-oncehttps://joanayebola.vercel.app/blog/kubernetes-probes-explained/https://joanayebola.vercel.app/blog/kubernetes-probes-explained/Learn what liveness, readiness, and startup probes actually control, how they fail in production, and how to configure all three correctly.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialkubernetesdevopsreliabilitycontainershttps://joanayebola.vercel.app/blog/llm-response-caching/https://joanayebola.vercel.app/blog/llm-response-caching/Design an LLM response cache that actually saves money: exact-match keys, versioned prompts, tenant isolation, and the strict rules for when semantic caching is safe.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialcachingllmperformancepythonhttps://joanayebola.vercel.app/blog/local-llm-ollama-tooling/https://joanayebola.vercel.app/blog/local-llm-ollama-tooling/Install Ollama, serve models over its native and OpenAI-compatible APIs, tune context and quantization, and connect editors, CLIs, and scripts.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialollamalocal-llmopenai-compatibledeveloper-toolinghttps://joanayebola.vercel.app/blog/mcp-resources-prompts-sampling/https://joanayebola.vercel.app/blog/mcp-resources-prompts-sampling/Tools get all the attention, but MCP's resources, prompts, and sampling are what make a server feel native. Build a small server that uses all three.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialmcptypescriptai-toolingprotocolhttps://joanayebola.vercel.app/blog/oauth-pkce-flow-explained/https://joanayebola.vercel.app/blog/oauth-pkce-flow-explained/Walk the authorization code flow with PKCE exactly as a browser app runs it, including the verifier math, state checks, and token storage decisions.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformstutorialoauthpkceauthenticationspasecurityhttps://joanayebola.vercel.app/blog/openapi-code-generation/https://joanayebola.vercel.app/blog/openapi-code-generation/Turn your OpenAPI document into typed clients: pick a generator, wire it into CI so drift fails the build, and handle auth, errors, and versioning without hand-written wrappers.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformstutorialopenapicode-generationtypescriptapi-clientsdxhttps://joanayebola.vercel.app/blog/prometheus-metric-design/https://joanayebola.vercel.app/blog/prometheus-metric-design/Design Prometheus metrics that stay queryable under load: naming, label discipline, histograms, and the PromQL for errors, latency, and saturation.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialprometheuspromqlobservabilitymetricssrehttps://joanayebola.vercel.app/blog/prompt-injection-defense/https://joanayebola.vercel.app/blog/prompt-injection-defense/Prompt injection works because models cannot tell instructions from data. Defend in depth: separate the two, constrain tools, validate actions, and assume breach.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialprompt-injectionsecurityllmproductionhttps://joanayebola.vercel.app/blog/quickstart-rewrite-walkthrough/https://joanayebola.vercel.app/blog/quickstart-rewrite-walkthrough/A step-by-step rewrite method that turns a feature-tour quickstart into a task-first guide ending in a verifiable first success.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxtutorialquickstartsdeveloper-experiencetechnical-writingonboardinghttps://joanayebola.vercel.app/blog/rag-pipeline-evaluation/https://joanayebola.vercel.app/blog/rag-pipeline-evaluation/Build a repeatable evaluation harness for your retrieval-augmented generation pipeline: golden datasets, retrieval metrics, faithfulness checks, and CI gates.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialragevaluationllmpythonhttps://joanayebola.vercel.app/blog/readme-craft/https://joanayebola.vercel.app/blog/readme-craft/How to structure a README that converts a curious visitor into a running install, then into a first contribution.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxtutorialreadmeopen-sourcedocumentationdeveloper-experiencehttps://joanayebola.vercel.app/blog/rfc-9457-problem-details/https://joanayebola.vercel.app/blog/rfc-9457-problem-details/Replace ad-hoc error JSON with RFC 9457 problem details: a standard envelope, extension members for validation, and a migration path that keeps old clients working.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformstutorialapi-designrfc-9457error-handlingrestexpresshttps://joanayebola.vercel.app/blog/schema-evolution-avro-protobuf/https://joanayebola.vercel.app/blog/schema-evolution-avro-protobuf/A practical guide to evolving Avro and Protobuf schemas safely with compatibility modes, registries, and expand-and-contract deployments.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringtutorialavroprotobufschema-registrydata-engineeringkafkahttps://joanayebola.vercel.app/blog/slo-error-budgets/https://joanayebola.vercel.app/blog/slo-error-budgets/Build a lean SLO practice for a small team: pick few user-facing SLIs, set defensible targets, add burn-rate alerts, and enforce an error budget policy.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialsloerror-budgetsobservabilityalertingsrehttps://joanayebola.vercel.app/blog/streaming-llm-responses/https://joanayebola.vercel.app/blog/streaming-llm-responses/Build production-ready token streaming with SSE, ReadableStream, backpressure, aborts, and loading states that tell the truth.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialllmstreamingtypescriptserver-sent-eventsweb-apishttps://joanayebola.vercel.app/blog/streaming-vs-batch-latency-budget/https://joanayebola.vercel.app/blog/streaming-vs-batch-latency-budget/Choose between streaming, micro-batch, and batch by deriving a latency budget from the consumer decision, not by following tooling trends.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringcomparisonstreamingbatch-processinglatencydata-pipelinesarchitecturehttps://joanayebola.vercel.app/blog/structured-logging-nodejs/https://joanayebola.vercel.app/blog/structured-logging-nodejs/Build structured JSON logging in Node.js with correlation IDs, redaction, and error serialization so you can trace failures quickly during incidents.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialnodejsloggingobservabilitypinoincident-responsehttps://joanayebola.vercel.app/blog/structured-outputs-llm-apis/https://joanayebola.vercel.app/blog/structured-outputs-llm-apis/Get reliably typed data out of LLM APIs: strict schemas, parser-backed validation, retry loops that fix errors, and the failure modes that survive all three.Sat, 24 Oct 2026 00:00:00 GMTai-developer-toolingtutorialstructured-outputsllm-apispydanticpythonhttps://joanayebola.vercel.app/blog/subscription-billing-state-machine/https://joanayebola.vercel.app/blog/subscription-billing-state-machine/Model subscriptions as an explicit state machine driven by payment webhooks: states, transitions, proration rules, and a dunning sequence that recovers failed payments.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformstutorialbillingstate-machineswebhookssaaspaymentshttps://joanayebola.vercel.app/blog/terraform-module-design/https://joanayebola.vercel.app/blog/terraform-module-design/Design Terraform modules with narrow interfaces, honest versioning, and clean state boundaries so other teams adopt them instead of copying and forking them.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitytutorialterraforminfrastructure-as-codemodulesplatform-engineeringhttps://joanayebola.vercel.app/blog/trace-sampling-strategies/https://joanayebola.vercel.app/blog/trace-sampling-strategies/Compare head, tail, and rate-based trace sampling by what each keeps, what each silently drops, and how to combine them without losing the traces that matter.Sat, 24 Oct 2026 00:00:00 GMTdevops-observabilitycomparisonopentelemetrydistributed-tracingsamplingobservabilityhttps://joanayebola.vercel.app/blog/twilio-docs-teardown/https://joanayebola.vercel.app/blog/twilio-docs-teardown/How Twilio's quickstarts are engineered as a funnel: pre-written code, a working result in minutes, and a deliberate handoff from first success to production depth.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxdocs-teardowndocumentationquickstartsdeveloper-experiencedocs-teardowntwiliohttps://joanayebola.vercel.app/blog/vercel-docs-teardown/https://joanayebola.vercel.app/blog/vercel-docs-teardown/A teardown of Vercel's docs: how task-based navigation, framework-aware content, and honest limits pages turn a platform manual into a guided developer journey.Sat, 24 Oct 2026 00:00:00 GMTdocumentation-dxdocs-teardowndocumentationdeveloper-experiencedocs-teardownvercelhttps://joanayebola.vercel.app/blog/warehouse-cost-control/https://joanayebola.vercel.app/blog/warehouse-cost-control/Cut warehouse spend by finding expensive queries, fixing pruning and sizing, and adding guardrails that stop waste before it becomes the bill.Sat, 24 Oct 2026 00:00:00 GMTdata-engineeringopiniondata-warehousingcost-optimizationsqlanalytics-engineeringfinopshttps://joanayebola.vercel.app/blog/webhook-idempotency/https://joanayebola.vercel.app/blog/webhook-idempotency/Build a webhook receiver that safely handles duplicates, retries, and replays without double-charging customers or corrupting state.Sat, 24 Oct 2026 00:00:00 GMTapis-developer-platformstutorialwebhooksidempotencyapi-designdistributed-systemshttps://joanayebola.vercel.app/blog/orchestrate-airbyte-dbt-pipeline-kestra/https://joanayebola.vercel.app/blog/orchestrate-airbyte-dbt-pipeline-kestra/Build an automated ELT pipeline that runs an Airbyte sync, waits for completion, executes dbt models, and reports status through Kestra.Wed, 21 Oct 2026 00:00:00 GMTdata-engineeringtutorialKestraAirbytedbtPostgreSQLELThttps://joanayebola.vercel.app/blog/deploy-managed-kubernetes-github-actions/https://joanayebola.vercel.app/blog/deploy-managed-kubernetes-github-actions/Build a GitHub Actions pipeline that tests a Node.js app, publishes its Docker image to GHCR, and deploys it to DigitalOcean Kubernetes.Tue, 20 Oct 2026 00:00:00 GMTdevops-observabilitytutorialGitHub ActionsKubernetesDockerDigitalOceanCI/CDhttps://joanayebola.vercel.app/blog/opentelemetry-nodejs-signoz-tracing/https://joanayebola.vercel.app/blog/opentelemetry-nodejs-signoz-tracing/Trace Express, Postgres, outbound HTTP calls, and custom business logic with OpenTelemetry and SigNoz, including the correct ESM and TypeScript setup.Sun, 18 Oct 2026 00:00:00 GMTdevops-observabilitytutorialOpenTelemetrySigNozNode.jsTypeScriptDistributed tracinghttps://joanayebola.vercel.app/blog/paystack-vs-flutterwave-vs-stripe-api-docs/https://joanayebola.vercel.app/blog/paystack-vs-flutterwave-vs-stripe-api-docs/A documentation teardown of Paystack, Flutterwave v4, and Stripe for Nigerian developers—from test keys to server verification and a working webhook.Sun, 18 Oct 2026 00:00:00 GMTdocumentation-dxdocs-teardownPaystackFlutterwaveStripePayment APIsDeveloper experiencehttps://joanayebola.vercel.app/blog/airbyte-postgres-to-bigquery-cdc/https://joanayebola.vercel.app/blog/airbyte-postgres-to-bigquery-cdc/Set up Postgres-to-BigQuery replication with Airbyte CDC, then diagnose six failures involving WAL, permissions, data types, keys, and schema changes.Sat, 17 Oct 2026 00:00:00 GMTdata-engineeringtutorialAirbytePostgreSQLBigQueryChange data capturehttps://joanayebola.vercel.app/blog/build-mcp-server-typescript-sdk-v2/https://joanayebola.vercel.app/blog/build-mcp-server-typescript-sdk-v2/Build a local Markdown search server with MCP TypeScript SDK v2, test it with Inspector, and connect it to Claude Desktop, Cursor, and Codex.Fri, 02 Oct 2026 00:00:00 GMTai-developer-toolingtutorialMCPTypeScriptClaudeCursorCodex