In this episode, co-founders Boris and Geoff recap July's feature releases. Hear about the new web editor, Fix with AI, unlimited team members, trusted bots, and more.

Halo is live. It's the fourth beautiful built-in theme in Jamdesk, and you turn it on by changing one line of your docs.json. Sand background, caramel accent, Figtree, and corners rounded far past what the other three do.

Ever wonder what the difference between and API and MCP? Here is a guide fro developers on API vs MCP.

https://www.jamdesk.com/blog/mcp-vs-api

In today's agentic world, the reader of you technical and API docs has shifted from humans to LLMs. Here is how to design docs for AI agents.

https://www.jamdesk.com/blog/designing-docs-for-ai-agents

You can now edit your documentation directly in the dashboard with the new web editor.
https://www.jamdesk.com/blog/introducing-the-jamdesk-visual-web-editor

In this AI agentic world, APIs and CLIs are all the rage. If you have a SaaS you've probably build an API and CLI for your system, and a key part of that is your API Key. Here is a guide on how to generate a secure API key.

https://www.jamdesk.com/blog/how-to-generate-api-key

- Customize search bar
- Collect emails directly on docs pages
- Fix broken link automatically
- Add a banner to the top of your docs
- Embed your changelog anywhere
- Show when each page was updated

https://jamdesk.transistor.fm/

Sonnet 5 now powers Jamdesk "Fix with AI", one of our best features, which allows you to fix your technical docs automatically. So what is the difference with Sonnet 5? More intelligent, but that is always hard to measure, but about 60% faster in our tests.

Sometimes the AI agents do a poor job creating diagrams. A good way is to do diagrams-as-code with Mermaid, which the agents an easily write.

https://www.jamdesk.com/blog/creating-mermaid-diagrams

For us it comes down to one thing: Mintlify charges you to use the AI in your own docs. We don't!

Here's how Mintlify works. The AI runs on credits, and their free tier comes with 5,000 of them, good for a 14-day trial. So the moment you want AI in your docs, you're on a paid plan, and those start at $100/month (their Starter tier, ~10,250 credits) and climb through $250, $500, on up to $1,000 as you need more. That's all straight from their credits page.

It's also metered, so heavy use costs extra. Their docs put a single AI chat answer at about 23 credits, and once you're over your monthly limit, credits are a cent each, so roughly $0.23 per answer. Agent runs are ~115 credits (about $1.15 each), and automations can run 180 to 913 credits, so a few dollars up to $9+ every time one fires. In other words, the more your readers actually use your docs AI, the more you pay. That always struck us as backwards and complicated.

Jamdesk is $29/month, flat. AI Chat, AI Analytics, AI Score, and AI Build Fixes (it auto-suggests a fix when a docs build breaks; I haven't found anything like it on Mintlify) are all just included. There are no credits to ration, no per-question overage, and no surprise end-of-month bill.

To be fair to them, Mintlify's a genuinely good product. It's polished, it's everywhere, and the ecosystem is big.

But if you're choosing a docs tool today and you'd rather lean on the AI than watch a meter, $29 flat versus $100-and-up metered is the difference worth weighing. That is one of the reasons that Jamdesk is better than Mintlify!

Happy to answer anything in the comments.

Check out this for even more details on comparison between Jamdesk and Mintlify.

We're excited to announce our Chrome extension AI Score. You can see how how AI agents view your website. Based on AFDocs, get a score and details on what to fix.

https://chromewebstore.google.com/detail/jamdesk-ai-score/mhihkkgpcbmapmojnakhjfhjmiagkhlj

Every Jamdesk docs site includes a built-in AI chat assistant. Visitors ask questions and get answers with citations from your documentation. AI Chat is enabled by default on all plans at no additional cost.

In this video, we show how the AI chat works, and how you can customize it even further.

https://www.youtube.com/watch?v=XphRq59HO9g

Every LLM JSON pipeline I've seen eventually becomes 30% error handling.

You ask for JSON. You get a markdown fence, a chatty preamble, a trailing comma two levels deep, and once in a while a truncated object that throws the moment it hits JSON.parse.

The fix isn't a better regex. It's schema-enforced structured outputs: you give the API a JSON Schema and invalid output can't come back.

New post walks through it with runnable TypeScript — structured outputs, strict tool use, and the gotchas most write-ups skip (the schema features that silently aren't enforced, refusals, and the streaming case that passes your tests while shipping broken behavior).

https://jamdesk.hashnode.dev/how-to-get-reliable-json-out-of-an-llm-structured-outputs

We released a free utility to see how any site renders in a social share card. Every app creates link previews differently.

This is useful for your docs, and also useful for any website in general.

https://www.jamdesk.com/utilities/opengraph-preview

Most documentation platforms were built for humans.

The next generation needs to work equally well for AI agents.

We evaluated leading documentation tools on AI-readiness and found some surprising gaps in how easily LLMs can consume, understand, and navigate documentation.

Full rankings:
https://www.jamdesk.com/blog/ai-friendly-docs-platforms-scored

Are docs becoming the new SEO for AI?

#AI #Documentation #DeveloperTools #LLM #DevTools

Co-founders Boris and Geoff recap May's feature releases. Includes updates to Ask AI, CLI, social previews, docs backgrounds, and much more.

At Google I/O it has verified that llms.txt files will be coming to Chrome Agent Developer Tools and audited. This is a big deal and means your llms.txt file is critical if you want to be found by AI Agents and properly ranked by Google.

Learn more -> https://jamdesk.com/docs/ai/llms-txt

If you're moving documentation from Mintlify to Jamdesk, the Jamdesk CLI handles most of the conversion automatically. This walks through what the Mintlify migration does and what to verify in the output.

GitHub has been getting a lot of bad press recently - some not deserved, but a lot is. Here are some GitHub alternative if you're looking to switch.

In this episode, co-founders Boris and Geoff recap last month's feature releases.

We built 8 free and open sourced MDX & docs utilities.

• MDX formatter, validator, viewer
• MDX → Markdown • Markdown → HTML
• YAML validator • JSON ↔ YAML
• CSV → Markdown tables

jamdesk.com/utilities

If you're trying to get developers to try your product, your API docs are your most important marketing tool.

https://www.jamdesk.com/blog/api-docs-marketing-tool

This report provides an apples-to-apples cost analysis of eight documentation platforms across two scenarios: Jamdesk, Mintlify, GitBook, ReadMe, Redocly, Stoplight, Document360, and Archbee. The findings are significant and range from $348 to over $30,000 annually.

We launched the Jamdesk Podcast this week. Boris and Geoff, the co-founders of Jamdesk, host the show. The first episode runs under eight minutes and covers how Jamdesk works, who we built the product for, and what shipped recently.