public-blogs/

This is docs_dir — everything here is built and deployed.

Structure

public-blogs/
├── index.md                # site home — grid cards linking to sections
├── .authors.yml            # author registry (add new authors here)
├── assets/                 # avatar.svg, favicon.svg
├── stylesheets/extra.css   # theme overrides — CSS variables at top
├── platform-engineering/   # section
├── ai-ml/                  # section
├── travel/                 # section
└── casual/                 # section

Adding an author

Edit .authors.yml:

authors:
  handle:
    name: Full Name
    description: One-line bio
    avatar: assets/avatar.svg
    url: https://example.com

Then reference with authors: [handle] in post front matter.

Changing theme colours

Edit stylesheets/extra.css — CSS variables are at the top of the file under :root {}.

Generated files (do not edit)

Path	Generated by
site/	make build — full HTML output
site/feed_rss_created.xml	mkdocs-rss-plugin
site/feed_rss_updated.xml	mkdocs-rss-plugin
site/assets/images/social/*.png	Material social plugin
.social_cards_cache/	Social plugin card cache — safe to delete

What NOT to put here

• Draft or unfinished posts → use draft-blogs/ instead
• Uploaded images without an assets/ subfolder entry
• Anything in site/ — it is overwritten on every build