Reserve Article URLs for legacy routes

Author: HeyItsGilbert

.github/workflows/add-article.yml

@@ -72,15 +72,13 @@ jobs:
           if not slug:
               # Title was only punctuation / non-ASCII — fall back to the issue number.
               slug = f"article-{os.environ['ISSUE_NUMBER']}"
-          route = f"/articles/{today.strftime('%Y-%m-%d')}-{slug}/"
 
           fm = {
               'title': title,
               'author': author,
               'authors': [author] if author else [],
               'date': date_str,
               'description': description,
-              'url': route,
           }
           if category:
               fm['categories'] = [category]

CONTRIBUTING.md

@@ -32,7 +32,6 @@ If you're not comfortable with Git, you can pitch or submit your article through
    authors:
      - Your Name
    date: "YYYY-MM-DDT00:00:00+00:00"
-   url: /articles/YYYY-MM-DD-your-article-slug/
    categories:
      - Category Name
    tags:
@@ -41,8 +40,11 @@ If you're not comfortable with Git, you can pitch or submit your article through
    ---
 
    Your article content in Markdown goes here.
+
    ```
 
+   The Article URL is derived from this hierarchy as `/articles/YYYY/MM/your-article-slug/`. Do not add `url:` for a new Article; it is reserved for migrated Articles that preserve a historic dated URL.
+
    > Tip: create a new Article with Hugo from the repository root. Set `$slug` to a lowercase, hyphenated title, then replace the generated front matter values:
    >
    > ```powershell

README.md

@@ -10,10 +10,8 @@ PowerShell.org stewards.
 You're in the right place — most contributions don't require running the site at
 all. **[`CONTRIBUTING.md`](CONTRIBUTING.md)** walks you through each one:
 
-- **Write a guest blog post** — submit a Markdown article via a GitHub issue form
-  or a pull request to `content/articles/`.
-- **Add your author profile** — an avatar, bio, and links on your `/authors/<you>/`
-  page. Profiles are opt-in; your byline works without one.
+- **Write a guest blog post** — submit a Markdown Article via a GitHub issue form or a pull request. Articles are organized in `content/articles/` by publication year and month.
+- **Add your Author Profile** — an avatar, bio, and links on your `/authors/<you>/` page. Profiles are opt-in; your byline works without one.
 - **Submit a community event** — get your PowerShell event onto the calendar.
 - **Report a bug or broken link** — open an issue.
 

archetypes/articles.md

@@ -5,7 +5,6 @@ author: ""
 authors:
   - ""
 date: '{{ .Date }}'
-url: '/articles/{{ .Date.Format "2006-01-02" }}-{{ .File.ContentBaseName }}/'
 categories: []
 tags: []
 draft: true

scripts/validate-article-bundles.mjs

@@ -50,19 +50,19 @@ for (const path of walk(contentRoot).filter((path) => path.endsWith(`${sep}index
   if (parts.length !== 4 || !/^\d{4}$/.test(parts[0]) || !/^\d{2}$/.test(parts[1])) continue;
   const markdown = readFileSync(path, 'utf8');
   const metadata = frontMatter(markdown);
-  const route = stringValue(metadata, 'url');
-  if (!route) fail(`Article must declare its preserved dated URL: ${path}`);
-  else sourceArticles.set(route, { aliases: listValues(metadata, 'aliases'), authors: listValues(metadata, 'authors'), categories: listValues(metadata, 'categories'), tags: listValues(metadata, 'tags'), year: parts[0], month: parts[1], path });
+  const explicitRoute = stringValue(metadata, 'url');
+  const route = explicitRoute ?? `/articles/${parts[0]}/${parts[1]}/${parts[2]}/`;
+  sourceArticles.set(route, { aliases: listValues(metadata, 'aliases'), authors: listValues(metadata, 'authors'), categories: listValues(metadata, 'categories'), tags: listValues(metadata, 'tags'), explicitRoute, year: parts[0], month: parts[1], path });
   for (const asset of markdown.matchAll(/\]\((\/images\/articles\/[^)#?]+)/g)) {
     if (!existsSync(join(outputRoot, asset[1].replace(/^\//, '')))) fail(`Referenced static asset is missing: ${asset[1]} (${path})`);
   }
 }
 
 const inventoryByRoute = new Map(inventory.map((article) => [article.route, article]));
-for (const route of sourceArticles.keys()) if (!inventoryByRoute.has(route)) fail(`Unexpected Article route: ${route}`);
+for (const [route, source] of sourceArticles) if (source.explicitRoute && !inventoryByRoute.has(route)) fail(`Unexpected preserved Article route: ${route}`);
 for (const article of inventory) {
   const source = sourceArticles.get(article.route);
-  if (!source) { fail(`Missing migrated Article for preserved route: ${article.route}`); continue; }
+  if (!source || source.explicitRoute !== article.route) { fail(`Missing migrated Article for preserved route: ${article.route}`); continue; }
   if (article.aliases.some((alias) => !source.aliases.includes(alias))) fail(`Article aliases changed: ${article.route}`);
   for (const field of ['authors', 'categories', 'tags']) if (JSON.stringify(source[field]) !== JSON.stringify(article[field])) fail(`Article ${field} changed: ${article.route}`);
   if (article.draft) continue;