Merge pull request #110 from dansysanalyst/troubleshooting

improve troubleshooting
Power-Components · May 24, 2024 · 3068232 · 3068232
2 parents 34bb043 + 3ccbbdd
commit 3068232
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 8 deletions.
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -75,8 +75,8 @@ export default defineConfig({
         text: '🚀 Get Started',
         items: [
           { text: 'Introduction', link: '/get-started/introduction' },
-          { text: 'Code Examples', link: '/get-started/code-examples' },
-          { text: 'Troubleshooting', link: '/get-started/troubleshooting' },
+          { text: '⌨️ Code Examples', link: '/get-started/code-examples' },
+          { text: '🧨 Troubleshooting', link: '/get-started/troubleshooting' },
           { text: '1. Install', link: '/get-started/install' },
           { text: '2. PowerGrid Configuration', link: '/get-started/powergrid-configuration' },
           { text: '3. Create a PowerGrid Table', link: '/get-started/create-powergrid-table' },

diff --git a/docs/get-started/troubleshooting.md b/docs/get-started/troubleshooting.md
@@ -2,17 +2,25 @@
 
 This section covers the most frequent issues that users may encounter while using PowerGrid.
 
-## Undefined variable $foobar
+Here you will find:
 
-refer to [Theme, layout, view and "variable undefined" errors](/get-started/troubleshooting.html#theme-layout-view-and-variable-undefined-errors).
+[[toc]]
 
+## Multiple instances of Alpine
 
-## Call to undefined method fooBar()
+If you are installing PowerGrid with Laravel Breeze, you may come across this particular issue.
 
-Please check the [Upgrade Guide](/release-notes-and-upgrade/upgrade-guide.html).
+Please refer to Livewire Documentation [Multiple instances of Alpine](https://livewire.laravel.com/docs/troubleshooting#multiple-instances-of-alpine).
+
+## Undefined variable "$foobar"
 
-Additionally, refer to [Theme, layout, view and "variable undefined" errors](/get-started/troubleshooting.html#theme-layout-view-and-variable-undefined-errors).
+Please refer to [Theme, layout, view and "variable undefined" errors](/get-started/troubleshooting.html#theme-layout-view-and-variable-undefined-errors).
 
+## Call to undefined method "fooBar()"
+
+Please check the [Upgrade Guide](/release-notes-and-upgrade/upgrade-guide.html).
+
+Additionally, you may also learn the section [Theme, layout, view and "variable undefined" errors](/get-started/troubleshooting.html#theme-layout-view-and-variable-undefined-errors).
 
 ## Theme, layout, view and "variable undefined" errors
 
@@ -32,9 +40,14 @@ Next, clear Laravel caches. Run the command below.
 php artisan optimize:clear
 ```
 
+## Failed to mount filter: Filter::datetime
+
+You must install Flatpickr. Please refer to the section [Plugins Configuration >
+Flatpickr](/get-started/powergrid-configuration.html#flatpickr).
+
 ## Flatpickr Locale Support
 
-Sometimes Flatpick will not support your location's locale setting.
+Sometimes Flatpickr will not support your location's locale setting.
 
 For example, consider that your application is configured for `pt_BR` in `config/app.php` with `'locale' => 'pt_BR'`,