@rm-industries/create-forge 0.4.0-beta.3 → 0.4.0-beta.4

package/dist/template/docs/guides/content-and-cms.md

@@ -18,14 +18,14 @@ tags:
 draft: false
 ---
 
-# My first article
-
 Write the article body here.
 ```
 
 The file name becomes the article slug. Use a unique lowercase, hyphenated file
 name. Required fields, dates, defaults, and body content are validated during
-development, type checking, and builds.
+development, type checking, and builds. Do not repeat the title as a top-level
+Markdown heading: the front matter `title` is the article's document title, and
+the article layout renders it as the page heading.
 
 Set `draft: true` while writing. Draft articles appear during local development
 but are omitted from production article pages and RSS output. Before publishing:

package/dist/template/scripts/documentation-examples.test.ts

@@ -0,0 +1,13 @@
+import { readFile } from 'node:fs/promises';
+
+import { describe, expect, it } from 'vitest';
+
+describe('documentation examples', () => {
+  it('does not duplicate the article title as a Markdown heading', async () => {
+    const guide = await readFile(new URL('../docs/guides/content-and-cms.md', import.meta.url), 'utf8');
+    const articleExample = /```md\n([\s\S]*?)\n```/u.exec(guide)?.[1];
+
+    expect(articleExample).toContain('title: My first article');
+    expect(articleExample).not.toMatch(/^# /mu);
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rm-industries/create-forge",
-  "version": "0.4.0-beta.3",
+  "version": "0.4.0-beta.4",
   "description": "Create a content-driven Forge website",
   "keywords": [
     "astro",