Meta tags:
description=Writing docs that AI agents can actually use means doing content work and relying on platform scaffolding. Here s what I do, and what I can t.;

Headings (most frequently used words):

making, not, how, and, our, friendly, content, ai, just, pages, documentation, agent, writing, can, act, on, docs, flows, executable, readable, explaining, systems, steps, stripping, down, for, agents, keeping, scoped, current, findable, parseable,

Text of the page (most frequently used words):
the (73), and (44), docs (26), for (24), agent (23), that (21), #content (20), page (18), fern (17), our (14), llms (14), but (13), agents (13), how (12), with (11), only (11), where (10), platform (10), pages (10), not (10), can (9), markdown (8), are (8), humans (8), quickstart (7), this (7), what (7), documentation (6), scaffolding (6), work (6), into (6), without (6), every (6), one (6), human (6), context (6), like (6), need (6), use (6), customers (5), cli (5), all (5), your (5), both (5), txt (5), make (5), clean (5), just (5), making (5), they (5), ask (5), about (5), facing (5), new (4), sdks (4), site (4), also (4), friendly (4), you (4), frontmatter (4), isn (4), stale (4), something (4), those (4), descriptions (4), them (4), any (4), other (4), has (4), was (4), whether (4), flow (4), get (4), thing (4), 2026 (3), company (3), support (3), blog (3), now (3), beautiful (3), want (3), from (3), chunking (3), still (3), down (3), keep (3), because (3), its (3), helps (3), search (3), retrieval (3), well (3), write (3), product (3), would (3), don (3), links (3), same (3), section (3), version (3), tags (3), right (3), decide (3), looking (3), feature (3), customer (3), there (3), should (3), through (3), doesn (3), needs (3), entire (3), here (3), extra (3), act (3), command (3), running (3), writing (3), pricing (2), careers (2), resources (2), getting (2), started (2), view (2), soc (2), systems (2), first (2), may (2), devin (2), logan (2), most (2), sides (2), working (2), together (2), start (2), score (2), generates (2), helping (2), great (2), monolithic (2), gives (2), add (2), flows (2), executable (2), system (2), internals (2), out (2), way (2), built (2), worse (2), focused (2), self (2), contained (2), scoped (2), index (2), didn (2), metadata (2), access (2), everything (2), keeping (2), when (2), title (2), say (2), actual (2), changes (2), different (2), response (2), short (2), pointer (2), find (2), full (2), expanded (2), api (2), sdk (2), decision (2), fetch (2), someone (2), enough (2), which (2), long (2), writer (2), might (2), more (2), hide (2), shouldn (2), either (2), current (2), jsx (2), image (2), variants (2), light (2), dark (2), mode (2), landing (2), next (2), block (2), stays (2), wrapped (2), their (2), gets (2), overview (2), reason (2), keyword (2), developer (2), surfaces (2), some (2), interaction (2), myself (2), claude (2), code (2), got (2), run (2), expect (2), commands (2), org (2), via (2), have (2), actually (2), read (2), day (2), tool (2), book (2), demo (2), sign (2), dev, located, brooklyn, york, postman, terms, service, privacy, policy, github, brand, kit, openapi, compatibility, revamping, website, designers, rebuilt, marketing, largest, sites, render, faster, interest, type, operational, subscribe, delight, developers, idiomatic, ones, see, yours, stand, decent, place, reverse, true, empty, anyone, strategy, over, retrieves, somewhere, land, worth, surfacing, strip, tag, exists, negotiation, decisions, collapses, clutter, leave, break, units, handles, ranking, bad, unfindable, perfect, reach, indexes, sitting, invisible, approaching, cold, consume, above, none, reaches, level, half, findability, stable, once, minor, change, renaming, typescript, url, slug, old, save, redirects, structural, moving, includes, top, telling, originally, maintained, hand, snippet, inside, pasted, scale, auto, prepends, fields, these, directly, treating, treat, commit, message, clear, specific, summary, subtitle, description, look, related, findable, parseable, bane, tech, existence, notice, looks, outdated, recent, will, confidently, relay, whatever, finds, even, deprecated, six, months, ago, actively, remove, early, ready, general, surface, answer, question, monolith, hit, token, limits, harder, breaking, motivation, accelerates, already, extreme, case, almost, entirely, rive, animations, custom, grids, barely, prose, source, deliberate, reading, paragraphs, feeling, motion, visual, hierarchy, sense, pieces, fit, opposite, care, polish, list, parallel, holds, table, contents, pointing, destinations, ignore, homepage, stripped, wayfinding, styling, rich, styled, card, groups, icons, exactly, design, earns, sets, tone, signals, kind, bearings, fetching, lot, component, boilerplate, references, css, class, names, around, very, little, stripping, shape, pattern, under, hood, numbered, breakdown, rag, pipeline, works, vector, rbac, filtering, fallback, plus, sequence, diagram, enabling, putting, straightforward, feel, requires, understanding, figure, why, own, others, absolutely, detail, keeps, action, oriented, giving, addition, procedural, sometimes, fix, explaining, steps, approach, quickstarts, require, candidate, iterated, multiple, times, adding, wherever, stuck, until, worked, live, having, single, used, verbose, file, structure, after, each, troubleshooting, tips, deal, interactive, autonomously, walks, installing, initializing, project, configuring, publishing, guided, option, means, able, summarize, goal, give, create, publish, prompting, name, domain, handling, configuration, execute, roughly, third, visitors, share, grow, readable, biggest, shift, thinking, hasn, been, density, though, matter, intent, asks, help, browsing, trying, come, believe, matters, craft, interdependent, talk, audiences, ceiling, side, alone, baseline, assumption, accessing, primarily, local, cursor, interface, people, good, structured, aren, tension, identical, maintain, contract, troubleshoot, onboard, prospects, evaluate, across, nine, languages, sole, technical, another, listen, podcast, min, back, free, readiness, compliant, secure, trust, center, hiring, learn, interact, terminal, client, libraries, designed, language, experts, customizable, websites, products,

Text of the page (random words):
how i m making our documentation agent friendly and how i m not fern products resources docs beautiful customizable documentation websites sdks client libraries designed by language experts cli interact with your api from the terminal documentation learn how to use fern careers we re hiring trust center soc 2 compliant and secure get your agent readiness score customers blog pricing sign in start for free book a demo sign in book a demo back to blog view as markdown how i m making our documentation agent friendly and how i m not may 15 2026 7 min read devin logan company docs listen as podcast 0 00 0 00 1 it s one thing to use ai to write the docs it s another thing to write docs that ai use i m the sole technical writer at fern where i maintain documentation for fern docs and sdks across nine languages our docs are a contract with the customer they re how current customers troubleshoot new customers onboard and prospects evaluate whether fern is the right tool for them my baseline assumption is that customers are accessing our docs primarily through agents whether that s via ask fern a local tool like claude code or cursor or some other ai interface this might be the first or only interaction people have with our docs and i want it to be a good one writing well structured docs for humans and writing for agents aren t in tension but they re not identical either the other thing i ve come to believe the content work only matters because the platform surfaces it to agents content craft and platform scaffolding are interdependent and i want to talk about both sides here s what i actually do day to day to make fern s docs work for both audiences and where the ceiling is for what i can do on the content side alone writing content ai can act on the biggest shift in my thinking hasn t been about keyword density or metadata though those matter it s about intent when a developer asks an ai agent for help with fern the agent isn t browsing it s trying to do something the docs need to support that making flows executable not just readable our docs quickstart is one of our most read pages by both humans and llms roughly a third of visitors to that page are llms and i expect that share to grow the quickstart walks you through installing the cli initializing a docs project configuring your org and publishing there s a guided ui option but the entire flow can also run via cli which means an ai agent should be able to execute the quickstart not just summarize it my goal was to give an agent the page and say create and publish a new docs site for me and have it actually do it prompting me for my org name and domain running the commands handling the configuration to get there i used llms only tags to add context agents need but humans don t more verbose content on file structure what to expect after running each command troubleshooting tips how to deal with interactive commands the human facing page stays clean and the agent gets the extra scaffolding to act autonomously i iterated on this myself running the entire flow multiple times with claude code and adding context wherever the agent got stuck until everything worked and i got a new live docs site without having to run a single command myself i ve expanded this approach to our sdk quickstarts and i m looking at other pages next any flow that doesn t require a ui interaction is a candidate explaining systems not just steps not every agent facing addition is procedural sometimes the thing an agent needs isn t a command or a fix it s enough context to reason about the system it s working with our ask fern overview has a short under the hood section in llms only tags a numbered breakdown of how the rag pipeline works chunking vector retrieval rbac filtering keyword fallback plus a sequence diagram a customer enabling ask fern doesn t need any of that and putting it on the page would make a straightforward feature feel like it requires understanding the internals to use but an agent helping a developer figure out why their own ask fern surfaces some pages and not others would absolutely use that detail llms only keeps the page action oriented for humans without giving up what the agent needs it s a different shape from the quickstart pattern the quickstart is here s extra scaffolding so you can act this is here s extra context so you can reason both are content humans don t need but agents do stripping down pages for agents our docs overview page is styled for humans and it should be card groups icons dark light mode variants all wrapped in jsx a landing page is exactly where design earns its keep it sets the tone signals what kind of product this is and helps someone get their bearings but an agent fetching that page gets a lot of component boilerplate image references and css class names wrapped around very little actual content so for pages like this agents now get a stripped down markdown version with the same wayfinding links but without the styling the human facing page stays rich the agent facing version is clean our homepage is the extreme case it s almost entirely rive animations custom jsx grids and image variants for light and dark mode there s barely any prose in the source at all that s deliberate a human landing on the site shouldn t be reading paragraphs they should be feeling the product through motion and visual hierarchy getting a sense of what fern is and how its pieces fit together an agent has the opposite need it doesn t care about polish it needs a clean list of where to go next so i hide the entire human facing block with llms ignore and a parallel llms only block holds a clean markdown table of contents pointing to the same destinations keeping content scoped and current long monolith pages hit token limits and make ai search retrieval harder but they re not great for humans either breaking them into focused self contained pages is one of those changes where the ai motivation just accelerates a decision that was already right stale content long the bane of a tech writer s existence is worse a human might notice a page looks outdated and go looking for something more recent an ai agent will confidently relay whatever it finds even if the feature was deprecated six months ago i actively remove or hide content that s stale or in early access if a feature isn t ready for general use the docs for it shouldn t be where ask fern can surface it as the answer to a customer question making pages findable and parseable agents need enough context to decide whether to fetch a page at all which section to look at and where to find related content descriptions are how agents decide whether to fetch a page at all fern docs has built in support for frontmatter fields like title description and subtitle and these flow directly into llms txt i ve started treating frontmatter the way i d treat a commit message a clear specific summary that helps someone or something decide if this is what they re looking for every markdown response also includes a short pointer at the top telling agents where to find the full docs index llms txt and the expanded version with api and sdk content llms full txt i originally maintained that pointer by hand a snippet inside llms only tags that i pasted into every page it was the right content decision but it didn t scale the platform now auto prepends it to every markdown response the other half of findability is keeping links stable once an agent has them when i make a minor change to a page title say renaming quickstart to typescript quickstart i keep the url slug the same the old links still work i save redirects for actual structural changes like moving a page to a different section how i m not making our docs ai friendly agents don t access and consume docs like humans do everything above is content work but none of it reaches an agent without platform level scaffolding i can write perfect product descriptions for every page but those descriptions only reach agents because fern generates an llms txt that indexes them if the platform didn t do that my descriptions would just be metadata sitting in frontmatter invisible to any agent approaching the docs cold i can break pages into focused self contained units but that only helps ai search if the platform handles chunking retrieval and ranking well a well scoped page in a bad search index is still unfindable i can add llms only content to make flows executable strip pages down to clean markdown or keep system internals out of the way but that tag only exists because the platform built it into its markdown content negotiation for agents without it every one of those decisions collapses into a worse one clutter the human page or leave the agent without context the reverse is also true a platform that generates a beautiful llms txt from empty frontmatter isn t helping anyone a great chunking strategy over stale monolithic content still retrieves stale monolithic content platform scaffolding gives content work somewhere to land content work gives platform scaffolding something worth surfacing the most ai friendly docs are the ones where both sides are working together and if you want to see where yours stand your agent score is a decent place to start devin logan may 15 2026 delight your developers with beautiful docs idiomatic sdks an agent first cli subscribe all systems operational soc 2 type ii also of interest our largest docs sites now render 6 4x faster how 2 designers and ai rebuilt fern s marketing site revamping our website view as markdown documentation getting started openapi compatibility docs sdks cli resources blog careers customers support pricing company brand kit github privacy policy terms of service 2026 fern a postman company located in brooklyn new york dev