From 6edad4fdb9169d6a7ccbfd033e8c58f14666848b Mon Sep 17 00:00:00 2001
From: Commander <danny@gositeme.com>
Date: Tue, 7 Apr 2026 16:58:33 -0400
Subject: [PATCH] =?UTF-8?q?README:=20full=20site=20documentation=20?=
 =?UTF-8?q?=E2=80=94=209=20pages,=20infrastructure,=20technical=20details?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 46 +++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b16ac5d..4d6b6e5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,47 @@
 # alfredlinux.com
 
-Official alfredlinux.com website — 9 pages, JSON-LD, P2P WebTorrent downloads, clean URLs.
\ No newline at end of file
+**Official website — 9 PHP pages, JSON-LD structured data, P2P WebTorrent downloads, Apache clean URLs.**
+
+Source code for [alfredlinux.com](https://alfredlinux.com) — the public face of Alfred Linux. Every page is a single PHP file with embedded HTML/CSS/JS. No framework, no CMS, no build step.
+
+## Pages
+
+| File | URL | Purpose |
+|------|-----|---------|
+| `index.php` | `/` | Homepage — hero, feature grid, download CTA, WebTorrent P2P |
+| `download.php` | `/download` | Download page with SHA-256 verification |
+| `compare.php` | `/compare` | Alfred Linux vs Ubuntu/Fedora/Arch — feature-by-feature |
+| `security.php` | `/security` | Security architecture — 32 modules documented |
+| `releases.php` | `/releases` | Release history (RC1→RC8) with changelogs |
+| `about.php` | `/about` | Company info, team, GoForge source links |
+| `developers.php` | `/developers` | Developer portal — SDKs, APIs, GoForge repos |
+| `apps.php` | `/apps` | Application ecosystem |
+| `docs.php` | `/docs` | Documentation — install guide, mobile setup, security |
+
+## Infrastructure
+
+| File | Purpose |
+|------|---------|
+| `.htaccess` | Apache rewrite rules for clean URLs, security headers, HTTPS redirect |
+| `robots.txt` | Search engine directives |
+| `sitemap.xml` | XML sitemap for all pages |
+| `404.html` | Custom 404 error page |
+
+## Technical Details
+
+- **Stack**: PHP 8.x, Apache 2.4, vanilla CSS/JS
+- **Structured data**: JSON-LD on every page (Organization, WebSite, SoftwareApplication)
+- **P2P downloads**: WebTorrent integration on download page — ISO distributed via browser P2P
+- **Security headers**: CSP, X-Frame-Options, X-Content-Type-Options via .htaccess
+- **No JavaScript frameworks**: Zero npm dependencies, zero build step
+- **Mobile responsive**: Every page works on mobile
+
+## Hosting
+
+- Hosted on GoSiteMe infrastructure (shared hosting with Apache)
+- Domain: alfredlinux.com
+- SSL: Let's Encrypt auto-renewal
+
+## License
+
+AGPL-3.0
\ No newline at end of file