Skip to content

fix: restore missing blog posts by fixing MDX file issues#7492

Merged
alexquincy merged 16 commits intomasterfrom
work/clever-rubin
Mar 11, 2026
Merged

fix: restore missing blog posts by fixing MDX file issues#7492
alexquincy merged 16 commits intomasterfrom
work/clever-rubin

Conversation

@leecalcote
Copy link
Copy Markdown
Member

Problem

Blog posts after August 24, 2023 were missing from https://layer5.io/blog despite being present in the repository. Those same posts were visible under https://layer5.io/resources (for posts with resource: true), confirming they existed but were not being processed correctly for the blog listing.

Root Cause

Two issues in src/collections/blog/:

1. Empty 0-byte MDX file

src/collections/blog/2023/09-05-layer5-and-intel-collaboration/index.mdx was a completely empty file (0 bytes). During gatsby build, this caused MDX compilation failures that aborted processing of all subsequent blog posts sorted alphabetically — everything after August 24, 2023.

2. Non-standard blog post filenames

27 blog posts used non-standard filenames (post.mdx, docker-compose-with-meshery.mdx, etc.) instead of the conventional index.mdx, causing inconsistent processing by the Gatsby MDX pipeline.

Fix

  • Removed the empty 09-05-layer5-and-intel-collaboration/index.mdx file
  • Renamed all 27 non-standard blog post files to index.mdx

Affected Posts Restored

  • 2023: hacktoberfest-2023
  • 2024: docker-compose-with-meshery, mythical-10x-engineer, meet-the-maintainer series (xin-huang, hussaina-begum, aisuko-li, aadhitya-amarendiran, yash-sharma), ways-to-contribute, docker-build-warning, what-is-the-kanvas-catalog, kubecon-na-2024
  • 2025: git-aliases, docker-model-runner series (6 posts), meet-the-maintainer-ian-whitney, meet-the-maintainer-aabid-sofi, agents-instructions, understanding-configmaps, kanvas-like-miro-but-more, gemini-cli-trusted-directories

Copilot AI review requested due to automatic review settings March 11, 2026 21:34
@github-actions github-actions bot added the area/blog New posts or new blog functionality label Mar 11, 2026
Two issues prevented blog posts after Aug 2023 from appearing on /blog:

1. Remove empty 0-byte index.mdx at 09-05-layer5-and-intel-collaboration/
   which caused MDX compilation failures during gatsby build, aborting
   processing of all subsequent blog posts alphabetically.

2. Rename 27 blog post files with non-standard names (post.mdx,
   docker-compose-with-meshery.mdx, git-aliases.mdx, etc.) to the
   conventional index.mdx to ensure consistent processing by the
   gatsby-plugin-mdx pipeline.

Blog posts with resource: true frontmatter were still visible on
/resources (which queries across collections) but absent from /blog
(which queries only the blog collection with published: true).

Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.

Comment on lines 134 to 137
Copy link

Copilot AI Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This table uses || row prefixes, which doesn’t conform to Markdown table syntax and is likely to render incorrectly. Use standard | ... | rows for all lines in the table.

Copilot uses AI. Check for mistakes.
@l5io
Copy link
Copy Markdown
Member

l5io commented Mar 11, 2026

🚀 Preview for commit 423cf2c at: https://69b1e40333f4fe38be39e44a--layer5.netlify.app

alexquincy and others added 6 commits March 11, 2026 16:55
…/index.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
…index.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
…marendiran/index.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
….mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
…/index.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
@l5io
Copy link
Copy Markdown
Member

l5io commented Mar 11, 2026

🚀 Preview for commit f8a03ff at: https://69b1e900e7809f379130d73a--layer5.netlify.app

@alexquincy
Copy link
Copy Markdown
Contributor

The intel blog post needs to be restored.

Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
@leecalcote
Copy link
Copy Markdown
Member Author

Got it!

leecalcote and others added 7 commits March 11, 2026 17:24
Co-authored-by: Lee Calcote <leecalcote@gmail.com>
Signed-off-by: Lee Calcote <leecalcote@gmail.com>
…ex.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
…ex.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
@alexquincy alexquincy merged commit f465eff into master Mar 11, 2026
2 of 4 checks passed
@alexquincy alexquincy deleted the work/clever-rubin branch March 11, 2026 22:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/blog New posts or new blog functionality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants