From 9e3c14adc60d0add3032f4ef31ef7b04fd025840 Mon Sep 17 00:00:00 2001
From: Walusimbi Silver <walusimbisilver90@gmail.com>
Date: Fri, 10 Jul 2026 11:12:59 +0300
Subject: [PATCH] Document preview and deployment workflow

---
 .gitattributes |  7 +++++++
 README.md      | 31 +++++++++++++++++++++++++++++--
 2 files changed, 36 insertions(+), 2 deletions(-)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..210c857
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,7 @@
+*.md text eol=lf
+*.html whitespace=cr-at-eol
+LICENSE text eol=lf
+
+*.jpeg binary
+*.jpg binary
+*.png binary
diff --git a/README.md b/README.md
index 01d38cc..fee9c75 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,30 @@
-# links
+# Links
 
-Personal links
\ No newline at end of file
+Personal links page for Walusimbi Silver, a software engineer based in Kampala, Uganda.
+
+Live site: [links.silverwal.com](https://links.silverwal.com/)
+
+## Local preview
+
+The site has no build step or runtime dependencies. Serve the repository root with any static file server:
+
+```bash
+python3 -m http.server 8000
+```
+
+Open `http://localhost:8000` in a browser.
+
+## Structure
+
+- `index.html` contains the page structure, styles and small scroll restoration script.
+- `pic.jpeg` is the optimized avatar and social preview image.
+
+## Updating
+
+Edit the profile text, destinations and metadata directly in `index.html`. Keep the canonical and social image URLs aligned with the production domain.
+
+When replacing `pic.jpeg`, use a square image and remove EXIF metadata before publishing it.
+
+## Deployment
+
+Deploy the repository root as a static site. The production host must serve `index.html` at `https://links.silverwal.com/` and `pic.jpeg` at the root path.