docs: add Docusaurus documentation site with GitHub Actions deployment (#36)

- Add comprehensive documentation site in docs/ folder (21 pages)
  - Getting Started: Installation, Quick Start, Why SGuard
  - Core Concepts: Guard methods, Callbacks, Custom Exceptions, Expression Caching
  - Guides: Null/Empty checks, Comparisons, Collections, Strings, Real-world examples
  - Advanced: Performance, Best Practices
  - API Reference: ThrowIf, Is, Callbacks
  - Community: Contributing, Code of Conduct, Changelog

- Add GitHub Actions workflow for automatic deployment to gh-pages
- Update README.md with documentation links
- Remove broken coverage badge from README
- Configure Docusaurus with SGuard branding and metadata
- Add .gitignore entries for Docusaurus build artifacts

Documentation will be available at: https://selcukgural.github.io/SGuard/

Author: selcukgural

.github/workflows/deploy-docs.yml

@@ -0,0 +1,45 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          cache-dependency-path: docs/package-lock.json
+          
+      - name: Install dependencies
+        working-directory: docs
+        run: npm ci
+        
+      - name: Build website
+        working-directory: docs
+        run: npm run build
+        
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/build
+          user_name: 'github-actions[bot]'
+          user_email: 'github-actions[bot]@users.noreply.github.com'
+          commit_message: 'Deploy documentation'

.gitignore

@@ -553,4 +553,8 @@ $RECYCLE.BIN/
 
 
 # Windows shortcuts
-*.lnk
+*.lnk
+# Docusaurus
+docs/.docusaurus/
+docs/build/
+docs/.cache-loader/

docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs/README.md

@@ -0,0 +1,41 @@
+# 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:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+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.