fix: correct broken links and update repository structure

- Fix broken .html links to .md format
- Update repository references from edge-mining to bitsalv
- Correct Discord invite link
- Update README to reflect actual repository structure
- Synchronize documentation between repositories

Author: bitsalv

README.md

@@ -4,25 +4,28 @@ This repository contains **only the documentation content** (Markdown files) for
 
 ## 🏗️ Repository Structure
 
-### **This Repository (`edge-mining/docs`):**
+### **This Repository (`bitsalv/edgemining-docs`):**
 ```
-edge-mining/docs/
-└── docs/                      # Documentation content ONLY
-    ├── intro.md              # Introduction
-    ├── about-us.md           # About Edge Mining
-    ├── product/              # Product documentation
-    │   └── product-cycle.md
-    ├── modelling/            # Architecture & DDD
-    │   ├── domain-driven-architecture-overview.md
-    │   └── glossary.md
-    ├── contribution.md       # How to contribute
-    └── faq.md               # Frequently asked questions
+edgemining-docs/
+├── docs/                      # Documentation content ONLY
+│   ├── intro.md              # Introduction
+│   ├── about-us.md           # About Edge Mining
+│   ├── product/              # Product documentation
+│   │   └── product-cycle.md
+│   ├── modelling/            # Architecture & DDD
+│   │   ├── README.md
+│   │   ├── domain-driven-architecture-overview.md
+│   │   └── glossary.md
+│   ├── contribution.md       # How to contribute
+│   └── faq.md               # Frequently asked questions
+├── images/                   # Documentation images
+└── .github/workflows/        # Sync workflow
 ```
 
-### **Site Repository (`edge-mining/edgemining.energy`):**
+### **Site Repository (`bitsalv/edgemining.energy`):**
 ```
-edge-mining/edgemining.energy/
-├── docs/                     # VuePress site (copied from this repo)
+edgemining.energy/
+├── docs/                     # VuePress site (synced from this repo)
 │   ├── .vuepress/           # VuePress configuration
 │   │   ├── config.js        # Site configuration
 │   │   ├── styles/          # Custom CSS styles
@@ -38,26 +41,26 @@ edge-mining/edgemining.energy/
 ### **Two-Way Sync Process:**
 
 #### **1. Content Changes (this repo):**
-- **Push to `edge-mining/docs`** → Triggers sync workflow
-- **Copies `docs/`** → `edge-mining/edgemining.energy/docs/`
+- **Push to `bitsalv/edgemining-docs`** → Triggers sync workflow
+- **Copies `docs/`** → `bitsalv/edgemining.energy/docs/`
 - **Triggers build** → Deploys to `edgemining.energy`
 
 #### **2. Site Changes (edgemining.energy repo):**
-- **Push to `edge-mining/edgemining.energy`** → Triggers build workflow
+- **Push to `bitsalv/edgemining.energy`** → Triggers build workflow
 - **Builds VuePress** → Deploys to `edgemining.energy`
 
 ## 🛠️ Setup Required
 
 ### **1. Repository Token**
-In the `edge-mining/docs` repository, add this secret:
+In the `bitsalv/edgemining-docs` repository, add this secret:
 ```
 EDGEMINING_ENERGY_TOKEN = Personal Access Token with permissions on edgemining.energy
 ```
 
 ### **2. Repository Permissions**
 The token must have access to:
-- `edge-mining/docs` (read)
-- `edge-mining/edgemining.energy` (read/write)
+- `bitsalv/edgemining-docs` (read)
+- `bitsalv/edgemining.energy` (read/write)
 
 ## 📝 Current Status
 
@@ -68,22 +71,25 @@ The token must have access to:
 - [x] Custom CSS styling with Edge Mining brand colors
 - [x] Logo and favicon from Edge Mining organization
 - [x] Navigation structure (Home, Docs, Discord, GitHub)
+- [x] Fixed broken links in documentation
+- [x] Synchronized content between repositories
 
 ### **⚠️ Pending:**
+- [ ] Configure `EDGEMINING_ENERGY_TOKEN` secret for automatic sync
+- [ ] Test deployment workflow
 - [ ] Content review and finalization
-- [ ] Visual design improvements
-- [ ] Testing of deployment workflow
 
 ## 🔧 Local Development
 
 ### **For Content Development (this repo):**
 ```bash
 # Edit Markdown files in docs/
-# Push to trigger automatic sync
+# Push to trigger automatic sync (when token is configured)
 ```
 
 ### **For Site Development (edgemining.energy repo):**
 ```bash
+cd edgemining.energy
 npm run docs:dev      # Development server
 npm run docs:build    # Production build
 npm run docs:clean    # Clean build
@@ -93,33 +99,35 @@ npm run docs:clean    # Clean build
 - **Development**: `http://localhost:8080/` (from edgemining.energy repo)
 - **Production**: `https://edgemining.energy`
 
-## 📋 Pull Request Checklist
+## 📋 Setup Checklist
 
-### **For `edge-mining/docs`:**
+### **For `bitsalv/edgemining-docs`:**
+- [x] Repository structure corrected
+- [x] Documentation links fixed
 - [ ] Add `EDGEMINING_ENERGY_TOKEN` secret
 - [ ] Configure repository permissions
 - [ ] Test content sync workflow
 
-### **For `edge-mining/edgemining.energy`:**
+### **For `bitsalv/edgemining.energy`:**
+- [x] VuePress configuration complete
+- [x] Build workflow functional
 - [ ] Enable GitHub Pages
 - [ ] Configure custom domain `edgemining.energy`
 - [ ] Set up CNAME file
-- [ ] Configure repository permissions
 
 ## 🎯 Next Steps
 
-1. **Create Pull Request** for `edge-mining/docs` (content only)
-2. **Create Pull Request** for `edge-mining/edgemining.energy` (VuePress site)
-3. **Configure secrets** and permissions
-4. **Test deployment workflow**
-5. **Review and finalize content**
+1. **Configure GitHub Secrets** for automatic sync
+2. **Test deployment workflow**
+3. **Review and finalize content**
+4. **Enable GitHub Pages** with custom domain
 
 ## 📚 Documentation Files
 
-- **`docs/docs/`** → All documentation content (this repo)
+- **`docs/`** → All documentation content (this repo)
 - **VuePress configuration** → In edgemining.energy repo
 - **Deployment workflows** → In both repositories
 
 ---
 
-**Note**: This repository contains ONLY the documentation content. The VuePress site and deployment infrastructure are in the `edge-mining/edgemining.energy` repository. 
+**Note**: This repository contains ONLY the documentation content. The VuePress site and deployment infrastructure are in the `bitsalv/edgemining.energy` repository. 

docs/intro.md

@@ -26,14 +26,14 @@ Edge Mining is currently in an **alpha stage** of development. Our research-driv
 
 To get involved with Edge Mining:
 
-1. **Explore the Documentation**: Start with our [About Us](/docs/about-us.html) page
-2. **Understand the Product**: Learn about our [Product Cycle](/docs/product/product-cycle.html)
-3. **Study the Architecture**: Dive into our [Domain-Driven Architecture](/docs/modelling/domain-driven-architecture-overview.html)
-4. **Join the Community**: Connect with us on [Discord](https://discord.gg/edgemining) and [GitHub](https://github.com/edge-mining/docs)
+1. **Explore the Documentation**: Start with our [About Us](./about-us.md) page
+2. **Understand the Product**: Learn about our [Product Cycle](./product/product-cycle.md)
+3. **Study the Architecture**: Dive into our [Domain-Driven Architecture](./modelling/domain-driven-architecture-overview.md)
+4. **Join the Community**: Connect with us on [Discord](https://discord.com/invite/VQa9UY5SsS) and [GitHub](https://github.com/bitsalv/edgemining.energy)
 
 ## Next Steps
 
-- [About Us](/docs/about-us.html) - Learn more about our mission and values
-- [Product Cycle](/docs/product/product-cycle.html) - Understand our development process
-- [Contribution](/docs/contribution.html) - Find out how to contribute
-- [FAQ](/docs/faq.html) - Get answers to common questions 
+- [About Us](./about-us.md) - Learn more about our mission and values
+- [Product Cycle](./product/product-cycle.md) - Understand our development process
+- [Contribution](./contribution.md) - Find out how to contribute
+- [FAQ](./faq.md) - Get answers to common questions 

docs/modelling/README.md

@@ -53,7 +53,7 @@ When contributing to the architecture:
 
 ## Related Resources
 
-- [Main Project Repository](https://github.com/edge-mining/docs)
+- [Main Project Repository](https://github.com/bitsalv/edgemining.energy)
 - [Domain-Driven Design Resources](https://martinfowler.com/bliki/DomainDrivenDesign.html)
 - [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
 - [Event Sourcing](https://martinfowler.com/eaaDev/EventSourcing.html)