Expand README with documentation links and enhanced examples

**Added Badges:**
- Python version support (3.8+)
- Test status (291 passing)
- Coverage percentage (96%)
- MIT License badge

**Enhanced Features Section:**
- Expanded to 9 analyzers with specific names
- Added SSRF protection highlight
- Emphasized test coverage and type safety
- Highlighted CI/CD readiness

**New Documentation Section:**
- Links to all 8 documentation files
- Architecture, API, Analyzers, Testing, Deployment
- Contributing, Security, Changelog references

**Enhanced Project Structure:**
- More detailed file descriptions
- Clear component purposes
- Test and CI/CD visibility

**Added Library Usage Section:**
- Python library usage example
- Import statements
- Basic fetch and analyze workflow
- Reference to API docs

**Enhanced Security Notes:**
- Listed security features explicitly
- SSRF protection details
- DNS rebinding validation
- SSL/TLS verification
- Known limitations with doc references

**Better Testing Section:**
- Multiple test command examples
- Coverage generation
- Specific test execution
- Reference to testing guide

**New Contributing Section:**
- Development setup link
- Coding standards reference
- Testing requirements
- PR process pointer

**Project Status Section:**
- Version, Python support
- Test count and coverage
- License info centralized

**Links Section:**
- GitHub repository
- Issue tracker
- Security policy
- Changelog

This provides comprehensive navigation to all
project resources and clear usage guidance.

Author: ThodorhsPerros

README.md

@@ -1,23 +1,22 @@
 # Security Header Analyzer
 
-A lightweight Python CLI tool that fetches and analyzes HTTP security headers according to Mozilla and OWASP best practices. This tool is designed for developers, penetration testers, and system administrators who want a quick, reliable way to evaluate the security posture of a website’s HTTP response headers.
+[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![Tests](https://img.shields.io/badge/tests-291%20passing-success.svg)](https://github.com/itheCreator1/security-header-analyzer/actions)
+[![Coverage](https://img.shields.io/badge/coverage-96%25-brightgreen.svg)](https://github.com/itheCreator1/security-header-analyzer)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A lightweight Python CLI tool that fetches and analyzes HTTP security headers according to Mozilla and OWASP best practices. This tool is designed for developers, penetration testers, and system administrators who want a quick, reliable way to evaluate the security posture of a website's HTTP response headers.
 
 ## 🚀 Features
 
-* Fetches HTTP response headers from a target URL
-* Analyzes security-related headers:
-
-  * Strict-Transport-Security (HSTS)
-  * Content-Security-Policy (CSP)
-  * X-Frame-Options
-  * X-Content-Type-Options
-  * Referrer-Policy
-* Provides categorized findings: **Critical**, **High**, **Medium**, **Low**
-* JSON output option for automation pipelines
-* Custom User-Agent support
-* Optional redirect blocking
-* Timeout and error handling
-* Clean, structured terminal reports
+* **9 Security Header Analyzers**: HSTS, CSP, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, COEP, COOP, CORP
+* **SSRF Protection**: Built-in safeguards against Server-Side Request Forgery attacks
+* **Multiple Output Formats**: Human-readable text or JSON for automation
+* **Severity Classification**: Issues categorized as Critical, High, Medium, or Low
+* **96% Test Coverage**: 291 comprehensive tests ensuring reliability
+* **Type Safety**: Full type hints with mypy support
+* **CI/CD Ready**: Easy integration with GitHub Actions, GitLab CI, Jenkins
+* **Extensible**: Add new header analyzers with minimal code changes
 
 ## 📦 Installation
 
@@ -55,34 +54,113 @@ python -m sha https://example.com
 --debug              Shows verbose debug logs
 ```
 
+## 📖 Documentation
+
+- **[Architecture Guide](docs/ARCHITECTURE.md)** - System design, components, and extensibility
+- **[API Documentation](docs/API.md)** - Library usage and programmatic access
+- **[Analyzer Reference](docs/ANALYZERS.md)** - Detailed header analysis specifications
+- **[Testing Guide](docs/TESTING.md)** - Running and writing tests
+- **[Deployment Guide](docs/DEPLOYMENT.md)** - CI/CD integration and production deployment
+- **[Contributing](CONTRIBUTING.md)** - Development workflow and guidelines
+- **[Security Policy](SECURITY.md)** - Vulnerability reporting and security considerations
+- **[Changelog](CHANGELOG.md)** - Version history and release notes
+
 ## 📁 Project Structure
 
 ```
 security-header-analyzer/
 ├── sha/                  # Main package
-│   ├── cli.py            # CLI entry point
-│   ├── fetcher.py        # HTTP fetching logic
-│   ├── analyzer.py       # Header analysis engine
-│   ├── reporter.py       # Formatting and reporting
-│   └── headers/          # Individual header analyzers
-└── tests/                # Unit tests (~96% coverage)
+│   ├── __init__.py       # Package initialization
+│   ├── __main__.py       # Module entry point
+│   ├── main.py           # CLI entry point
+│   ├── fetcher.py        # HTTP header fetching with SSRF protection
+│   ├── analyzer.py       # Analysis orchestration
+│   ├── reporter.py       # Report generation (text/JSON)
+│   ├── config.py         # Configuration and exceptions
+│   └── analyzers/        # Individual header analyzers (9 total)
+├── tests/                # Comprehensive test suite (291 tests, 96% coverage)
+├── docs/                 # Documentation
+└── .github/              # CI/CD workflows
+```
+
+## 💻 Library Usage
+
+Use as a Python library in your own code:
+
+```python
+from sha.fetcher import fetch_headers
+from sha.analyzer import analyze_headers
+from sha.reporter import generate_report
+
+# Fetch and analyze
+headers = fetch_headers("https://example.com")
+findings = analyze_headers(headers)
+
+# Generate report
+report = generate_report(findings, url="https://example.com", format="json")
+print(report)
 ```
 
+See [API Documentation](docs/API.md) for complete reference.
+
 ## 🛡 Security Notes
 
 The analyzer follows guidance from:
 
 * **Mozilla Web Security Guidelines**
 * **OWASP Secure Headers Project**
 
-While it includes basic SSRF protections, DNS rebinding and TOCTOU-style attacks may bypass certain checks. Do not expose this tool as a public API without additional safety measures.
+**Security Features:**
+- SSRF protection against private IP ranges
+- DNS rebinding validation
+- SSL/TLS certificate verification
+
+**Known Limitations:**
+- TOCTOU vulnerability in DNS resolution (documented in [SECURITY.md](SECURITY.md))
+- Do not expose as public API without additional safety measures
 
 ## 🧪 Running Tests
 
-```
+```bash
+# Run all tests
 pytest
+
+# With coverage
+pytest --cov=sha --cov-report=html
+
+# Run specific test
+pytest tests/test_hsts.py -v
 ```
 
+See [Testing Guide](docs/TESTING.md) for details.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for:
+- Development setup
+- Coding standards
+- Testing requirements
+- Pull request process
+
+## 📊 Project Status
+
+- **Version**: 1.0.0
+- **Python**: 3.8, 3.9, 3.10, 3.11, 3.12
+- **Tests**: 291 passing
+- **Coverage**: 96%
+- **License**: MIT
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/itheCreator1/security-header-analyzer)
+- [Issue Tracker](https://github.com/itheCreator1/security-header-analyzer/issues)
+- [Security Policy](SECURITY.md)
+- [Changelog](CHANGELOG.md)
+
 ## 📄 License
 
-MIT License
+MIT License - See [LICENSE](LICENSE) for details
+
+---
+
+**Made with security in mind** 🔒