From 6e2148c1f438c115f126474084680425f565af71 Mon Sep 17 00:00:00 2001
From: Patrick Kollitsch <83281+davidsneighbour@users.noreply.github.com>
Date: Fri, 15 May 2026 01:52:50 +0000
Subject: [PATCH] docs: add basic configuration examples

---
 README.md |   51 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 50 insertions(+), 1 deletions(-)

diff --git a/README.md b/README.md
index c3c2586..4e01df7 100644
--- a/README.md
+++ b/README.md
@@ -57,8 +57,57 @@
 * [Customisation](https://ananke-documentation.netlify.app/customisation/)
 * [Troubleshooting](https://ananke-documentation.netlify.app/troubleshooting/)
 
+## Basic configuration examples
+
+A post can define common metadata in its front matter. The default archetype already includes `date`, `tags`, `featured_image`, and `description`; add `author` and `categories` when you need them:
+
+```yaml
+---
+title: "Post title example"
+author: "Jane Example"
+date: 2026-05-15T00:00:00+07:00
+categories:
+  - News
+  - Updates
+tags:
+  - hugo
+  - ananke
+featured_image: "/images/post-image.jpg"
+description: "A short description for listings and metadata."
+---
+```
+
+Use `featured_image` for the smaller image shown with post teasers and previews. Store the image in your site, for example under `static/images/`, and reference it from the site root as `/images/post-image.jpg`.
+
+Add header navigation through Hugo's menu configuration:
+
+```toml
+[[menus.main]]
+name = "About"
+pageRef = "/about"
+weight = 10
+
+[[menus.main]]
+name = "Authors"
+pageRef = "/authors"
+weight = 20
+```
+
+Add footer follow links, including email, through the social follow configuration. The available network definitions live in `config/_default/params.toml`.
+
+```toml
+[params.ananke.social.follow]
+networks = ["email", "github"]
+
+[params.ananke.social.github]
+username = "example"
+
+[params.ananke.social.email]
+username = "hello@example.com"
+```
+
 ## Support and Contributions
 
 * Bug reports: [GitHub Issues](https://github.com/gohugo-ananke/ananke/issues)
 * Questions and feature ideas: [GitHub Discussions](https://github.com/gohugo-ananke/ananke/discussions)
-* Contribution guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+* Contribution guide: [CONTRIBUTING.md](CONTRIBUTING.md)
\ No newline at end of file

--
Gitblit v1.10.0