Upload complete PortPy documentation site

Author: msrahimii

.github/workflows/deploy.yml

@@ -0,0 +1,45 @@
+# Name of this GitHub Actions workflow (shows up in the Actions tab)
+name: Deploy MkDocs site to GitHub Pages
+
+# Trigger the workflow when pushing to the "main" branch
+on: 
+  push:
+    branches:
+      - main
+
+# Allow the workflow to write to the repository (needed to publish to gh-pages)
+permissions:
+  contents: write
+
+# Define the jobs that will run in this workflow
+jobs:
+  deploy: # Name of the job
+    runs-on: ubuntu-latest
+
+    steps:
+
+    # Step 1: Check out the code from the repository
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+     # Step 2: Set up Python (version 3.12) in the runner
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+     # Step 3: Install Python dependencies from requirements.txt located in the root directory
+      - name: Install dependencies from requirements.txt
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      # Step 4: Build the MkDocs site (outputs HTML to ./site)
+      - name: Build MkDocs site
+        run: mkdocs build
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }} # Auth token for pushing
+          publish_dir: ./site # Directory to deploy (default MkDocs output)

docs/about.md

@@ -0,0 +1,44 @@
+# PortPy
+
+> Modern Portfolio Optimization in Python
+
+---
+
+Welcome to **PortPy**! Effortlessly optimize, analyze, and visualize your investment portfolios with a modern, user-friendly Python library.
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/your-org/portpy/main/assets/logo.png" alt="PortPy Logo" width="180"/>
+</div>
+
+---
+
+## 🚀 Features
+
+- **Intuitive API** for portfolio construction and optimization
+- **Interactive visualizations** for risk and return analysis
+- **Jupyter notebook support** for reproducible research
+- **Extensive documentation** and real-world examples
+
+---
+
+## Get Started
+
+- [Installation Guide](installation.md)
+- [Quickstart Tutorial](quickstart.md)
+- [API Reference](reference/)
+- [GitHub Repository](https://github.com/your-org/portpy)
+
+---
+
+## Why PortPy?
+
+- Built for both beginners and professionals
+- Actively maintained and open source
+- Integrates seamlessly with the Python data science stack
+
+---
+
+<div align="center">
+  <a href="quickstart.md"><b>Start Optimizing Your Portfolio →</b></a>
+</div>
+