Merge pull request #35 from project-codeguard/develop

docs: Add FAQ to address empty directory after downloading release

Author: ramraaj25

README.md

@@ -48,7 +48,7 @@ Get started in minutes:
 2. **Copy to your project** - Place AI agent and IDE specific rules in your repository
 3. **Start coding** - AI assistants will automatically follow security best practices
 
-- Additional details in the [Get Started →](getting-started.md)
+- Additional details in the [Get Started →](https://project-codeguard.org/getting-started/)
 
 
 ## How It Works

docs/faq.md

@@ -25,6 +25,32 @@ This FAQ document provides clear, concise answers to help developers seamlessly
 
 ---
 
+## Q: Why does the downloaded release folder appear empty?
+
+**A:** After downloading and extracting the release, the folders may appear empty because the rule directories (`.cursor/`, `.windsurf/`, `.github/`) start with a dot (`.`) and are hidden by default on most operating systems.
+
+**To show hidden files:**
+
+=== "macOS"
+    
+    In Finder, navigate to the extracted `ide_rules/` folder and press ++cmd+shift+period++ to toggle the visibility of hidden files. You should now see the `.cursor/`, `.windsurf/`, and `.github/` directories.
+
+=== "Windows"
+    
+    In File Explorer:
+    
+    1. Navigate to the extracted `ide_rules/` folder
+    2. Click on the **View** tab in the ribbon
+    3. Check the **Hidden items** checkbox
+
+=== "Linux"
+    
+    In your file manager, press ++ctrl+h++ to toggle hidden files, or use `ls -la` in the terminal to view all files including hidden ones.
+
+Once hidden files are visible, you can copy the appropriate directory (`.cursor/`, `.windsurf/`, or `.github/`) to your project root.
+
+---
+
 ## Q: Can I use this with Claude Code?
 
 **A:** Yes! Claude Code automatically reads and follows instructions from a `CLAUDE.md` file in your project root. To use Project CodeGuard rules with Claude Code you can point to the Project CodeGuard rules in your `CLAUDE.md` file.

docs/index.md

@@ -15,7 +15,7 @@ AI coding agents are transforming software engineering, but this speed can intro
 
 Project CodeGuard solves this by embedding security best practices directly into AI coding agent workflows. 
 
-**Before,During, and After Code Generation.**
+**Before, During, and After Code Generation.**
 
 Project CodeGuard can be used **before**, **during** and **after** code generation. They can be used at the AI agent planning phase or for initial specification-driven engineering tasks. Project CodeGuard rules can also be used to prevent vulnerabilities from being introduced during code generation. They can also be used by automated code-review AI agents.