Publish your first article

This chapter walks through publishing entirely from the GitHub website.

1. Create the file

  1. Go to your repo and press . — or navigate to content/ and click Add file → Create new file.

  2. In the filename box, type the path and name in one go:

    content/2026/07/building-romyq.md

    Typing / in the filename box creates folders, so a new month needs no separate step.

    The filename becomes the URL slug: this file will publish at /2026/07/building-romyq/. Use lowercase words separated by hyphens.

2. Write the article

Paste this skeleton and edit it:

---
title: Building Romyq
description: Why I built an autonomous project manager.
date: 2026-07-12
tags:
  - rust
  - ai
---

The article body starts here, in plain Markdown.

Only title, description, date, and tags are needed for a normal post. The full list of fields is in the Frontmatter reference.

3. Commit

Click Commit changes. Commit directly to main — every push to main triggers a build and deploy.

4. Watch it go live

Open the Actions tab. The Deploy workflow takes roughly a minute. When it turns green, the article is live at:

https://blog.adarshrust.com/2026/07/building-romyq/

It will also automatically appear on the homepage, in /archive/, on its tag pages, in the RSS feed, the sitemap, and the search index.

Editing an existing article

Open the file on GitHub, click the pencil icon, edit, commit. Same pipeline, same result. Every article page also has an Edit on GitHub link in its footer that jumps straight to the right file.

If you make a meaningful update, set updated: 2026-07-15 in the frontmatter so readers (and search engines) see the revision date.