feat: add documentation sync task to Rakefile and update README

Author: route

README.md

@@ -1,19 +1,10 @@
-git submodule init
-git submodule update
-
-### Build Errors
-
-If you encounter build errors:
+## 🚀 Quick Start
 
 ```bash
-npm run clear  # Clear Docusaurus cache
-npm install    # Reinstall dependencies
-npm run build  # Try building again
+git submodule init
+git submodule update --recursive --remote
 ```
 
-
-## 🚀 Quick Start
-
 ### Prerequisites
 
 - Node.js 20 or higher
@@ -39,46 +30,12 @@ This command starts a local development server and opens up a browser window. Mo
 npm run build
 ```
 
+### Build Errors
 
-
-# Website
-
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
-
-## Installation
-
-```bash
-yarn
-```
-
-## Local Development
-
-```bash
-yarn start
-```
-
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
-
-## Build
-
-```bash
-yarn build
-```
-
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
-
-## Deployment
-
-Using SSH:
-
-```bash
-USE_SSH=true yarn deploy
-```
-
-Not using SSH:
+If you encounter build errors:
 
 ```bash
-GIT_USER=<Your GitHub username> yarn deploy
+npm run clear  # Clear Docusaurus cache
+npm install    # Reinstall dependencies
+npm run build  # Try building again
 ```
-
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

Rakefile

@@ -0,0 +1,37 @@
+require "fileutils"
+
+desc "Copy documentation files from projects to docs"
+task :sync_docs do
+  projects = {
+    "ferrum" => { source: "projects/ferrum/docs", dest: "docs/ferrum" },
+    "cuprite" => { source: "projects/cuprite/docs", dest: "docs/cuprite" },
+    "vessel" => { source: "projects/vessel/docs", dest: "docs/vessel" }
+  }
+
+  projects.each do |name, paths|
+    source_dir, dest_dir = paths.values_at(:source, :dest)
+
+    unless Dir.exist?(source_dir)
+      puts "⚠️  Skipping #{name}: #{source_dir} does not exist"
+      next
+    end
+
+    puts "📄 Syncing #{name} docs..."
+
+    # Ensure destination directory exists
+    FileUtils.mkdir_p(dest_dir)
+
+    # Copy all Markdown files
+    Dir.glob(File.join(source_dir, '*.md')).each do |file|
+      filename = File.basename(file)
+      dest_file = File.join(dest_dir, filename)
+
+      FileUtils.cp(file, dest_file)
+      puts "  ✓ Copied #{filename}"
+    end
+  end
+
+  puts "✅ Documentation sync complete!"
+end
+
+task default: :sync_docs