refactor: Enforce non-empty slugs and change guest plugin default

- Add validation to prevent empty slugs in plugins and resources
- Change guest plugin default slug from empty string to 'help'
- Update README to remove empty slug documentation
- All slugs must now be non-empty strings

Author: scott grayson

README.md

@@ -90,26 +90,25 @@ public function panel(Panel $panel): Panel
 {
     return $panel
         ->id('guest')
-        ->path('help') // Panel path
+        ->path('') // Panel path (empty = root, or set to your desired base path)
         // ... other panel configuration
         // Note: Do NOT add authMiddleware() for guest access
         ->plugins([
-            FilamentHelpGuestPlugin::make()
-                ->slug(''), // Optional: customize the URL slug (empty = use panel path)
-            //...
+            FilamentHelpGuestPlugin::make(),
+            // Default slug is 'help', so articles will be at /help (or {panel-path}/help)
+            // Customize with ->slug('custom-slug') if needed
         ]);
 }
 ```
 
 **Configuration Options:**
-- **Plugin method**: `->slug('custom-slug')` - Set the URL slug when registering the plugin (defaults to empty string `''` if not specified, which uses the panel path directly)
+- **Plugin method**: `->slug('custom-slug')` - Set the URL slug when registering the plugin (defaults to `'help'` if not specified)
+- **Slug requirement**: Slug must be a non-empty string
 
-**Location**: Guest panel (defaults to panel path, configurable via `->slug()`)  
+**Location**: Guest panel (defaults to `{panel-path}/help`, configurable via `->slug()`)  
 **Access**: Public (no authentication required)  
 **Features**: Read-only access to public help articles for guests
 
-**Note**: If you don't specify a slug (or pass an empty string), the help articles will be available directly at the panel path. For example, if your panel path is `help`, articles will be at `/help` and `/help/{slug}`.
-
 ## Help Article Locations
 
 Help articles are available in three different locations depending on your setup:

src/FilamentHelpFrontendPlugin.php

@@ -32,6 +32,10 @@ public function register(Panel $panel): void
         $defaultSlug = 'help';
         $slug = $this->slug ?? $defaultSlug;
 
+        if (empty($slug)) {
+            throw new \InvalidArgumentException('Slug cannot be empty. Please provide a non-empty slug when registering the plugin.');
+        }
+
         \Tapp\FilamentHelp\Resources\Frontend\HelpArticleResource::setSlug($slug);
 
         $panel

src/FilamentHelpGuestPlugin.php

@@ -28,10 +28,14 @@ public function getId(): string
 
     public function register(Panel $panel): void
     {
-        // Set the slug on the resource - use provided slug or default to empty string (uses panel path)
-        $defaultSlug = ''; // Empty string means use panel path directly
+        // Set the slug on the resource - use provided slug or default to 'help'
+        $defaultSlug = 'help';
         $slug = $this->slug ?? $defaultSlug;
 
+        if (empty($slug)) {
+            throw new \InvalidArgumentException('Slug cannot be empty. Please provide a non-empty slug when registering the plugin.');
+        }
+
         \Tapp\FilamentHelp\Resources\Guest\HelpArticleResource::setSlug($slug);
 
         $panel

src/Resources/Frontend/HelpArticleResource.php

@@ -31,6 +31,10 @@ public static function shouldRegisterNavigation(): bool
 
     public static function setSlug(string $slug): void
     {
+        if (empty($slug)) {
+            throw new \InvalidArgumentException('Slug cannot be empty.');
+        }
+
         static::$slug = $slug;
     }
 

src/Resources/Guest/HelpArticleResource.php

@@ -27,10 +27,14 @@ public static function shouldRegisterNavigation(): bool
 
     protected static ?string $modelLabel = 'Help Article';
 
-    protected static string $slug = '';
+    protected static string $slug = 'help';
 
     public static function setSlug(string $slug): void
     {
+        if (empty($slug)) {
+            throw new \InvalidArgumentException('Slug cannot be empty.');
+        }
+
         static::$slug = $slug;
     }