Make your documentation readable by AI agents

How to structure developer documentation so that AI agents like Claude Code, ChatGPT, Cursor, Copilot can discover, retrieve, and cite it accurately. Three layers: discovery, retrieval, and tools.

· Engineering · Artificial Intelligence

Agent Readability: A Specification for AI-Optimized Websites

Agent readability is a set of best practices that make your website parseable, navigable, and citable by AI agents like ChatGPT, Claude, Cursor, and Copilot. A site-wide spec across discovery, structure, and context.

· Engineering · Artificial Intelligence

Building Slack agents can be easy

Walk-through of the Vercel Slack agent skill, which takes a coding agent (Claude Code, OpenCode, Cursor) from idea to a deployed Slack bot in a single session — handling app config, OAuth, webhooks, and infra.

· Engineering · Artificial Intelligence

Recent

  1. Hello, Vercel.

    I’ve redeployed timothyjordan.com to Vercel, and I’m super excited to lead the Developer Experience team at a company famous for excellent developer experience.

  2. My exit from Google: we don't say goodbye, we say good journey.

    My farewell letter to 16 years at Google, some accomplishments, and a lot of gratitude.

  3. The Developer Relations Lifecycle

    A overview of the Developer Relations Lifecycle and how it lines up with the product development lifecycle.

  4. Google Prompting Essentials Online Course

    A self-paced, online course for learning how to prompt AI models like a pro.

  5. All Things Open 2024 Keynote: Google Summer of Code

    Had a lovely time celebrating 20 years of Google Summer of Code on stage at the All Things Open keynote this morning.

  6. Celebrating 20 Years of Google Summer of Code

    Reflecting on 20 years of Google Summer of Code — the open-source mentorship program that's connected 21,000+ contributors across 123 countries since 2005.

  7. Origins of the Google Developer Show

    I sat down with Dan Galpin a short while ago to talk about the origins of the Google Developer Show, a look back at the most exciting announcements…

  8. Get ready for Google I/O: Program lineup revealed

    Developers, get ready! Google I/O is just around the corner...

  9. AI + Open Source: A Philosophy of Changing Expectations

    Slides and speaking notes from my Open Source Summit NA 2024 keynote on what 'open' means for AI models and how the open-source community can help land it well.

  10. Enable Two-Factor Authentication for SSH on Ubuntu

    A step-by-step guide on enabling two-factor authentication for SSH on Ubuntu

  11. Roll Your Own Continuous Delivery

    A Google Cloud Build talk on rolling your own continuous delivery pipeline — design choices, integration with GitHub, and the trade-offs between using a managed product and a hand-built pipeline.

  12. The Developer Show — TL;DR 142

    The Google Developer Show, episode 142. Topics include Android Studio 3.3, Get your Android apps ready for 64-bit, Feast: open source feature store for machine learning, Go on Cloud Functions, NVIDIA Tesla T4 GPUs now in beta, and Soft Actor-Critic: Deep Reinforcement Learning for Robotics.

  13. The Developer Show — TL;DR 140

    The Google Developer Show, episode 140. Topics include Cloud DNS forwarding, Cloud SQL, Python 3.7 for App Engine, Cloud Spanner, and Chrome 72 Beta.

  14. The Developer Show — TL;DR 138

    The Google Developer Show, episode 138. Topics include Fast Pair Update, SDK Developers: stay up to date, New GCP regions in Hong Kong and Jakarta, Google Data Studio with Crashlytics data, and Chrome 72 DevTools.

  15. The Developer Show — TL;DR 137

    The Google Developer Show, episode 137. Topics include Wear OS by Google, Cloud Identity and secure LDAP, Associate Cloud Engineer certification in German, Google Cloud IoT and Microchip, Deeper performance insights in Firebase Performance Monitoring, and Redesigned Firebase notifications dashboard.

  16. The Developer Show — TL;DR 136

    The Google Developer Show, episode 136. Topics include NVIDIA Tesla T4 GPUs, Chrome Dev Summit 2018, Dart 2.1, and Register for DevFest OnAir.

  17. The Developer Show — TL;DR 135

    The Google Developer Show, episode 135. Topics include #AndroidDevSummit, AI Hub and Kubeflow Pipelines, Cloud Scheduler, Containerd in Google Kubernetes Engine, and 2018 Go User Survey.

  18. The Developer Show — TL;DR 134

    The Google Developer Show, episode 134. Topics include G Suite Developer Hub, Node.js 10 available for App Engine, BERT: State-of-the-Art Pre-training for Natural Language Processing, AdaNet: Fast and Flexible AutoML with Learning Guarantees, and Google at EMNLP 2018.

  19. The Developer Show — TL;DR 133

    The Google Developer Show, episode 133. Topics include Free training for Android developers, Firebase Summit 2018, Cloud KMS plugin for HashiCorp Vault, Private DNS Zones, and Chrome 71 Beta.

  20. The Developer Show — TL;DR 132

    The Google Developer Show, episode 132. Topics include Build better apps in a smaller bundle, Spinnaker’s Kubernetes support, Gmail Compose Actions, Go 1.11 on App Engine, and Is there life on other planets?.

  21. The Developer Show — TL;DR 131

    The Google Developer Show, episode 131. Topics include Introducing Oboe: C++ library for low latency audio, #AndroidDevSummit on November 7–8, Google Cloud Next London, Active Question Reformulation with Reinforcement Learning, What’s New In DevTools (Chrome 71), and Flutter Live on December 4th.

subscribe via RSS