From f5eafe5fa4ab7519b14c70b45da3bd7ba7131e95 Mon Sep 17 00:00:00 2001
From: Fred Mutabazi <133762699+FREDPENTA5@users.noreply.github.com>
Date: Mon, 23 Mar 2026 13:00:35 +0300
Subject: [PATCH] docs: expand BOS overview and contribution starting point

---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 2973e74..1b0c2be 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,21 @@
 # BOS
 BOS (Bugema Operating System) the internet OS! Free, Open Source, Self hostable
+
+## Overview
+BOS (Bugema Operating System) is an open-source project that aims to make self-hosted
+web services feel more like an “operating system” for everyday internet usage.
+
+## Getting Started
+At the moment, this repository primarily contains documentation (see `LICENSE` and this
+README). A common next step for contributors is to:
+
+1. Fork the repository.
+2. Create a documentation-focused branch (for example: `docs/add-overview`).
+3. Add missing sections such as installation/setup instructions, architecture notes,
+   and contribution guidelines.
+
+If you add real installation or deployment steps later, please also update this section
+to reflect the new workflow.
+
+## License
+MIT License (see `LICENSE`).