docs: consolidate documentation into organized structure

- Move 12 markdown files from root to docs/ subdirectories
- Organize documentation by category:
  • docs/troubleshooting/ (1 file)  - Technical troubleshooting guides
  • docs/deployment/      (4 files) - Deployment and security documentation
  • docs/guides/          (3 files) - Feature-specific guides
  • docs/planning/        (4 files) - Planning and improvement proposals

Root directory cleanup:
- Reduced from 16 to 4 markdown files in root
- Only essential project files remain:
  • CLAUDE.md (AI instructions)
  • README.md (Main project readme)
  • CLEANUP_PLAN.md (Current cleanup plan)
  • SRC_STRUCTURE_IMPROVEMENTS.md (Structure improvements)

This improves:
✅ Documentation discoverability
✅ Logical organization by purpose
✅ Clean root directory
✅ Better maintainability

src/Framework/Meta/MetaData.php

@@ -10,11 +10,24 @@ final readonly class MetaData
         public string $title,
         public string $description = '',
         public OpenGraph $openGraph = new OpenGraphTypeWebsite(),
-    ) {}
+    ) {
+    }
+
+    public static function create(string $title, string $description = '', OpenGraphType $ogType = OpenGraphType::WEBSITE): self
+    {
+        return new self(
+            title: $title,
+            description: $description,
+            openGraph: match($ogType) {
+                OpenGraphType::WEBSITE => new OpenGraphTypeWebsite(),
+                OpenGraphType::ARTICLE => new OpenGraphTypeWebsite(), // TODO: Create OpenGraphTypeArticle
+                default => new OpenGraphTypeWebsite(),
+            }
+        );
+    }
 
     public function __toString(): string
     {
-
         return (string) new MetaTag(MetaTagName::DESCRIPTION, $this->description);
     }
 }

src/Framework/Meta/MetaTag.php

@@ -1,4 +1,5 @@
 <?php
+
 declare(strict_types=1);
 
 namespace App\Framework\Meta;
@@ -8,7 +9,8 @@ final readonly class MetaTag
     public function __construct(
         public MetaTagName|MetaTagProperty $type,
         public string      $content,
-    ) {}
+    ) {
+    }
 
     private function getTypeName(): string
     {

src/Framework/Meta/MetaTagName.php

@@ -1,4 +1,5 @@
 <?php
+
 declare(strict_types=1);
 
 namespace App\Framework\Meta;

src/Framework/Meta/MetaTagProperty.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace App\Framework\Meta;
 
 enum MetaTagProperty: string