URLs and file layout

The rule #

content/YYYY/MM/slug.md  →  https://blog.adarshrust.com/YYYY/MM/slug/

The URL comes from where the file sits, and the slug from the filename. The frontmatter date orders the article but does not affect the URL. That split is deliberate: you can correct a date without breaking every link to the article.

Choosing filenames #

The filename should simply describe the article:

content/2026/07/building-romyq.md
content/2026/07/rust-career-path.md
content/2026/07/life-in-bangalore.md

• Lowercase, hyphen-separated words.
• No dates in the filename — the folders already carry year and month.
• Filenames must be unique within their month (they can repeat across months, since the URL includes YYYY/MM/).

Keep URLs stable #

Once an article is published, its URL is a promise. Renaming or moving the file changes the URL and breaks inbound links, feeds readers already fetched, and search engine entries. Fix typos in the title: freely — it does not touch the URL. Only rename a file if the article is very fresh or you accept the breakage.

Growing over time #

New year or month? Just include it in the path when creating a file — content/2027/01/first-post.md — and the folder, the month listing (/2027/01/), and the archive entry all come into existence on their own. Empty months simply don't exist; there is nothing to pre-create and nothing to clean up.

The structure scales to thousands of posts: each month stays a small folder, and every page of the site is regenerated from scratch on each build, so nothing drifts.