Merge remote-tracking branch 'upstream/master'

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,8 +1,16 @@
 name: Bug report
 description: File a bug report
-labels: [bug]
+labels: [ bug ]
 title: "[BUG]: "
 body:
+ - type: markdown
+ attributes:
+ value: |
+ Please **do not** open an issue for applications with invisible windows leaving ghost tiles.
+
+ You can run `komorebic visible-windows` when the ghost tile is present on your workspace to retrieve the invisible window's exe, class name and title, and then use that to [ignore the window](https://lgug2z.github.io/komorebi/common-workflows/ignore-windows.html) responsible for the ghost tile.
+
+ If it is not possible to uniquely identify the invisible window resulting in a ghost tile through a mixture of exe, title and class identifiers , then this is not a bug with komorebi but a bug with the application you are using, and should open an issue with the developer(s) of that application.
  - type: textarea
  validations:
  required: true

docs/troubleshooting.md

@@ -1,5 +1,15 @@
 # Troubleshooting
 
+## Phantom Tiles
+
+Sometimes you may experience an application which leaves "ghost tiles" on a workspace, where there is space reserved for
+a window but no window visible.
+
+You can ignore these windows by following these steps:
+
+* Run `komorebic visible-windows` to find details about the invisible window
+* Using that information, [create a rule to ignore that window](common-workflows/ignore-windows.md)
+
 ## AutoHotKey executable not found
 
 If you try to start komorebi with AHK using `komorebic start --ahk`, and you have
@@ -85,10 +95,10 @@ running `komorebic stop` and `komorebic start`.
 
  To avoid waiting an eternity:
 
- - _Control Panel_ -> _Hardware and Sound_ -> _Power Options_ -> _Edit Plan
- Settings_
+  - _Control Panel_ -> _Hardware and Sound_ -> _Power Options_ -> _Edit Plan
+  Settings_
 
- _Turn off the display: 1 minute_
+  _Turn off the display: 1 minute_
 
  Allow a minute for the display to reset, then once it actually shuts off
  allow for any additional time as prompted by your monitor for the cycle to