From 1d7d3f44e17150ae8c76bb97271aaff5012a55c9 Mon Sep 17 00:00:00 2001 From: Phan An Date: Thu, 18 Apr 2024 22:19:49 +0200 Subject: [PATCH] doc: add more troubleshooting hints --- app/Console/Commands/InitCommand.php | 2 +- docs/troubleshooting.md | 6 +++++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/app/Console/Commands/InitCommand.php b/app/Console/Commands/InitCommand.php index 2d2a1b8b..6f79f4e0 100644 --- a/app/Console/Commands/InitCommand.php +++ b/app/Console/Commands/InitCommand.php @@ -70,7 +70,7 @@ class InitCommand extends Command $this->components->error("Oops! Koel installation or upgrade didn't finish successfully."); $this->components->error('Please check the error log at storage/logs/laravel.log and try again.'); - $this->components->error('You can also visit ' . config('koel.misc.docs_url') . ' for other options.'); + $this->components->error('For further troubleshooting, visit https://docs.koel.dev/troubleshooting.'); $this->components->error('😥 Sorry for this. You deserve better.'); return self::FAILURE; diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index c76eb947..6edb87fe 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -20,9 +20,13 @@ If you receive an error, the first step is to take a look at `storage/logs/larav Next, look at the browser console for any JavaScript errors. While you're at it, check the network tab for any failed requests and try disabling the network cache. -Also, try clearing the cache and recompiling the front-end assets. Below are a couple of commands that might help in this area: +Also, try clearing the cache, reinstalling dependencies, and recompiling the front-end assets. +Below are a couple of commands that might help in this area: ```bash +# Remove Composer vendor/ directory and reinstall the packages +rm -rf vendor && composer install + # Clear node_modules, re-install, and re-build the front-end assets rm -rf node_modules && yarn install && yarn build