ci: improve documentation build process and enhance developer guide

Author: umerfarok

.github/workflows/pages.yml

@@ -37,30 +37,34 @@ jobs:
 
       - name: Build documentation
         run: |
-          mkdir -p docs/downloads
-          cp README.md docs/index.md
-          cp DEVELOPER.md docs/guide/developer.md
+          # Create all required directories first
+          mkdir -p docs/{guide,downloads}
           
-          # Create downloads page with version info
-          cat > docs/downloads/index.md << 'EOL'
-          # Downloads
+          # Create index from README
+          cp README.md docs/index.md || echo "# NetworkMonitor" > docs/index.md
           
-          ## Latest Release
-          EOL
+          # Copy or create developer guide
+          cp DEVELOPER.md docs/guide/developer.md || echo "# Developer Guide" > docs/guide/developer.md
           
-          # Get latest release info using GitHub API
+          # Get version info
           if [ -n "${{ github.event.release.tag_name }}" ]; then
-            # Use the current release info if this is a release event
             VERSION="${{ github.event.release.tag_name }}"
             DATE=$(date -d "${{ github.event.release.published_at }}" +%Y-%m-%d)
           else
-            # Otherwise fetch latest release info
-            LATEST_RELEASE=$(curl -s -H "Accept: application/vnd.github.v3+json" \
+            # Fetch latest release info
+            LATEST_RELEASE=$(curl -s -H "Accept: application/vnd.github+json" \
+              -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
               "https://api.github.com/repos/${{ github.repository }}/releases/latest")
             VERSION=$(echo "$LATEST_RELEASE" | jq -r .tag_name)
             DATE=$(echo "$LATEST_RELEASE" | jq -r .published_at | cut -d'T' -f1)
           fi
           
+          cat > docs/downloads/index.md << 'EOL'
+          # Downloads
+          
+          ## Latest Release
+          EOL
+          
           cat >> docs/downloads/index.md << EOL
           
           Version: ${VERSION} (Released: ${DATE})

DEVELOPER.md

@@ -564,4 +564,37 @@ Critical packages:
 
 # Developer Documentation
 
-[Copy content from your existing DEVELOPER.md or create a basic guide]
+# Developer Guide
+
+## Setup Development Environment
+
+1. Prerequisites:
+   - Python 3.9 or later
+   - Npcap (Windows only)
+   - Git
+
+2. Clone and Setup:
+   ```bash
+   git clone https://github.com/umerfarok/netmoniter.git
+   cd netmoniter
+   python -m venv venv
+   source venv/bin/activate  # or `venv\Scripts\activate` on Windows
+   pip install -r requirements.txt
+   pip install -r requirements-build.txt
+   ```
+
+## Building
+
+```bash
+python build.py
+```
+
+## Testing
+
+```bash
+python -m pytest tests/
+```
+
+## Contributing
+
+See CONTRIBUTING.md for guidelines.