Reorganize documentation into structured docs/ folder for GitHub Pages

[Copilot]

Consolidates scattered documentation files into a hierarchical docs/ structure suitable for GitHub Pages deployment.

Changes

File Organization

• Moved 40 markdown files from website/documents/, ansible/, BACON/, and issues/ into categorized subdirectories
• Kept standard files (CODE_OF_CONDUCT.md, CONTRIBUTING.md, LICENSE.md, SECURITY.md) in root directory per GitHub conventions
• Created 8 logical categories: community/ (links to root), setup/, architecture/, features/, pages/, development/, troubleshooting/, legal/
• Each subdirectory contains a README for navigation context

Static Content Extraction

• Extracted Terms of Service from website/templates/mobile_terms.html to docs/legal/terms-of-service.md
• Extracted Privacy Policy from website/templates/mobile_privacy.html to docs/legal/privacy-policy.md
• Created markdown documentation for legal pages that were previously only in HTML templates

GitHub Pages Configuration

• docs/index.md - Central navigation hub linking all documentation sections
• docs/_config.yml - Jekyll configuration with Cayman theme
• .github/workflows/deploy-docs.yml - Auto-deployment on docs/ changes

Reference Updates

• Updated links in root README.md, .github/copilot-instructions.md, and website/templates/includes/sidenav.html
• All references now point to correct locations (root for standard files, docs/ for project documentation)
• Changed documentation URL from individual file links to https://owasp-blt.github.io/BLT/

Structure

Root Directory (standard files per GitHub conventions)
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE.md
└── SECURITY.md

docs/
├── index.md
├── community/      # Links to root standard files
├── setup/          # Installation guides, bot setup, webhooks, Ansible
├── architecture/   # System design, mermaid diagrams, proposals
├── features/       # Feature docs, GitHub Actions, BACON, file reference
├── pages/          # 24 page-specific UI documentation files
├── legal/          # Terms of Service, Privacy Policy (extracted from templates)
├── development/    # Developer workflow guides
└── troubleshooting/

Enables browsable documentation site once GitHub Pages is enabled in repository settings.

Original prompt

Look at all pages in this project and if they can be moved into docs then do that also organize the docs folder so it works as a documentation github pages app

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[DonnieBLT]

@copilot lets keep the standard files in their place - also look through the website regular pages and anything mostly static can go here

[Copilot]

@copilot lets keep the standard files in their place - also look through the website regular pages and anything mostly static can go here

Done! Standard files (CODE_OF_CONDUCT.md, CONTRIBUTING.md, LICENSE.md, SECURITY.md) are now back in the root directory. I've also extracted static content from the Terms and Privacy pages in website/templates/ and created markdown versions in docs/legal/:

• docs/legal/terms-of-service.md - Terms and conditions
• docs/legal/privacy-policy.md - Privacy policy

All references throughout the codebase have been updated to point to the correct locations. Commit: 8525086