From a3f272a48e6ef686b77a2bde2ae462544e76e30d Mon Sep 17 00:00:00 2001 From: rmcrackan Date: Fri, 22 May 2026 15:00:34 -0400 Subject: [PATCH] #1835 - add log file guidance to FAQ --- .github/ISSUE_TEMPLATE/config.yml | 1 + docs/frequently-asked-questions.md | 18 +++++++++++++++++- 2 files changed, 18 insertions(+), 1 deletion(-) create mode 100644 .github/ISSUE_TEMPLATE/config.yml diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..3ba13e0c --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1 @@ +blank_issues_enabled: false diff --git a/docs/frequently-asked-questions.md b/docs/frequently-asked-questions.md index fd988ea1..826e492e 100644 --- a/docs/frequently-asked-questions.md +++ b/docs/frequently-asked-questions.md @@ -2,7 +2,23 @@ ## Where Can I Get Help For My Specific Problem? -You can open an issue here for bug reports, feature requests, or specialized help. +You can open an issue here for bug reports, feature requests, or specialized help. For bug reports, attach your log file (see [Where Can I Find the Log File?](#where-can-i-find-the-log-file) below). Reports with limited information or no log may get limited or delayed help. + +## Where Can I Find the Log File? + +Libation keeps its log files in your Libation files folder. When reporting a bug, attach the Libation log file from that folder. If the folder contains **LibationCrash.log**, attach that too. + +**Default log folder locations** + +| Platform | Folder | +| - | - | +| Windows | `%userprofile%\Libation` | +| macOS | `~/Library/Application Support/Libation` | +| Linux | `~/.local/share/Libation` | + +**macOS:** If that folder does not exist because Libation never starts, try launching from Terminal and note whether it works: `/Applications/Libation.app/Contents/MacOS/Libation` (see [Troubleshooting for macOS](/docs/advanced/troubleshoot#app-wont-start)). + +Alternatively, open the log folder from within Libation: open **Settings**, and on the first tab click **Open log folder**. ## What's the Difference Between 'Classic' and 'Chardonnay'?