Skip to content

Commit 06c6833

Browse files
authored
tweaks (#2275)
1 parent 078d1e8 commit 06c6833

File tree

2 files changed

+11
-9
lines changed

2 files changed

+11
-9
lines changed

blog/public/blog/xmlui-playground.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -63,18 +63,20 @@ If you want to make such a report, you can visit [xmlui-codefence-runner.netlify
6363
6464
If you find yourself [filing an issue](https://github.com/xmlui-org/xmlui/issues) that needs a solid reproduction, please give it a try.
6565
66+
## Help your AI assistants stay grounded
6667
68+
When you use the [XMLUI MCP server](https://github.com/xmlui-org/xmlui-mcp) with coding assistants like Claude or Copilot, they will prefer How To examples when available.
6769
70+
![use xmlui-mcp to find a how to](/blog/images/use-xmlui-mcp-to-find-a-howto.png)
6871
69-
<!--
70-
## Help AI assistants know the truth
72+
That's the gold standard response: a link to a known working pattern that proves its existence by running live. And because XMLUI is concise, the pattern doesn't occupy too much space in an AI's context window.
7173
72-
When you use the [XMLUI MCP server](https://github.com/xmlui-org/xmlui-mcp) with coding assistants like Claude or Copilot, they will prefer How To examples when available.
74+
When you ask a question for which an assistant cannot provide such a link, we tell it to admit that and refuse to invent undocumented syntax. They won't always comply but with a running playground that embodies ground truth you can often steer them away from rabbit holes. The more working patterns contributed to the project, the stronger that effect will be.
75+
76+
## Reproducible XMLUI
77+
78+
The common theme here is reproducibility. Whether it lives in a component doc, a How To, or a GitHub issue, an XMLUI codefence captures a piece of XMLUI behavior that you can replay consistently. That's useful for the XMLUI project itself but also for apps you build with XMLUI. Playgrounds that we can reliably reproduce and exchange make everything easier to build, document, debug, and maintain.
7379
74-
![use xmlui-mcp to find a how to](/blog/images/use-xmlui-mcp-to-find-a-howto.png)
7580
76-
That's the gold standard response: a link to a known working pattern that proves its existence by running live.
7781
78-
When you ask a question for which they cannot provide such a link, they are supposed to admit that, and to cite the rule that prohibits inventing undocumented syntax. That doesn't always happen yet, but it happens often enough to steer assistants away from imaginary rabbit holes.
79-
-->
8082

blog/src/Main.xmlui

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
image: "blog-scrabble.png"
1212
},
1313
{
14-
title: "The versatile XMLUI playground",
14+
title: "Reproducible XMLUI",
1515
slug: "xmlui-playground",
1616
description: "Use playgrounds to infuse docs with live examples, iterate on prototypes, and reproduce bugs.",
1717
author: "Jon Udell",
@@ -43,7 +43,7 @@
4343
label="An XMLUI-powered blog"
4444
to="/blog/{posts[0].slug}" />
4545
<NavLink
46-
label="The versatile XMLUI playground"
46+
label="Reproducible XMLUI"
4747
to="/blog/{posts[1].slug}" />
4848
<NavLink
4949
label="Introducing XMLUI"

0 commit comments

Comments
 (0)