docs: unify repository and website documentation

README.md

@@ -1,7 +1,7 @@
 <br />
 <div align="center">
   <a href="https://github.com/finos/git-proxy">
-    <img src="./docs/img/logo.png" alt="Logo" height="95">
+    <img src="./website/docs/development/architecture/img/logo.png" alt="Logo" height="95">
   </a>
 
   <br />

website/docs/index.mdx

@@ -6,4 +6,20 @@ title: Introduction
 
 GitProxy deploys custom push protections and policies on top of Git. It is a highly configurable framework allowing developers and organizations to enforce push protections relevant to their developer workflow, security posture and risk appetite.
 
-GitProxy is built with a developer-first mindset. By presenting simple-to-follow remediation instructions in the CLI/Terminal, it minimises the friction of use and adoption, and keeps developers focused on what matters; committing and pushing code.
+GitProxy is built with a developer-first mindset. By presenting simple-to-follow remediation instructions in the CLI/Terminal, it minimises the friction of use and adoption, and keeps developers focused on what matters: committing and pushing code.
+
+---
+
+### Documentation Structure
+
+- **Quickstart** – Get up and running fast  
+- **Configuration** – Setup and customise GitProxy  
+- **Development** – Architecture, processors, upgrading, and contributing  
+
+---
+
+### Key Technical Docs
+
+- [Architecture](./development/architecture/Architecture.md)
+- [Processors](./development/architecture/Processors.md)
+- [Upgrading to v2](./development/Upgrading%20to%20v2.md)