Merge branch 'origin/master'

docs/installation.md

@@ -0,0 +1,48 @@
+# Installation
+
+## Prerequisites
+
+**This application only works on Windows 10 x64 (64 bit) systems** due to limitations in the library used to control the virtual desktops.  
+This is not something that can be changed or _fixed_ in any way.
+
+For this app to work, you first might need to install "Visual C++ Redistributable for Visual Studio 2015". It should be available [here](https://www.microsoft.com/en-us/download/details.aspx?id=52685).
+
+Since [version 0.7.0](https://github.com/sdias/win-10-virtual-desktop-enhancer/releases/tag/0.7) this app will only work if your system has the "Windows 10 Anniversary" update (or later) installed.
+
+## Procedure
+
+Windows 10 Virtual Desktop Enhancer does not need to be installed: simply download [the latest version](https://github.com/sdias/win-10-virtual-desktop-enhancer/releases/latest) and extract it into a folder in your computer.  
+Once you have downloaded it you can run it just by executing `virtual-desktop-enhancer.exe` in the folder where you extracted it.
+
+Alternatively you can install [AutoHotkey](https://autohotkey.com/) and run the `virtual-desktop-enhancer.ahk` script file instead.
+
+### Autostart
+
+There are two easy ways to have this program automatically start when you login.  
+Please try the first procedure: if it does not work try the second one.
+
+#### Procedure 1: Autostart folder
+
+1. Open the folder where you saved the downloaded files
+2. Right click on the executable or on the script file (depending on which one you want to use) -> "Send to" -> "Desktop (create shortcut)"
+3. On your desktop there should now be a new shortcut for "virtual-desktop-enhancer.exe": right click on it -> "cut"
+4. Open the Start menu; in the search box enter "run" and open the "Run" program which should be the first result
+5. In the box which will pop up enter `shell:startup` and click "OK"
+6. A folder will open: right click in the folder -> "Paste"
+7. Now if you restart the computer the program should start automatically
+
+#### Procedure 2: Task scheduler
+
+1. Open the Start menu and in the search box enter "run": open the "Run" program which should be the first result
+2. In the box which will pop up enter `Taskschd.msc` and click "OK"
+3. In the menu of window that will open click "Action" -> "Create Basic Task"
+4. Choose a name and a description for the task (e.g. "win10-virtual-desktop-enhancer starter") and press "Next"
+5. Choose "When I log on" and click "Next"
+6. Choose "Start a program" and click "Next"
+7. Click on "Browse" and select the "virtual-desktop-enhancer.exe" file in the folder where you have extracted it and click "Next"
+8. Verify that all the settings are correct and click "End"
+9. You can now close the window: if you restart the computer Windows 10 Virtual Desktop Enhancer should start automatically
+
+## Request assistance
+
+If you have problems with the installation of Windows 10 Virtual Desktop Enhancer please submit a new issue in the project page as described [here](issue-page.md).

docs/issue-page.md

@@ -0,0 +1,49 @@
+# Issue page: what is it?
+
+The _Issue page_ of a project is a service on GitHub which, despite its name, lets the users and  the developers of a project communicate easily about pretty much anything related to the project itself.  
+Its main use is to submit bugs and problem found while using the program, but, depending on the project and its administrators it can also be used to ask for new features in next releases, ask questions and receive help.
+
+## Windows 10 Virtual Desktop Enhancer's issue page
+
+[Here](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues/) you can find Windows 10 Virtual Desktop Enhancer's Issue page.  
+If you open that link you will find a list of open issues (which have not been solved yet) and old closed (solved) issues as well.
+
+### When should I open a new issue?
+
+If you have found yourself in any of these situations:
+
+- You have experienced any problem using this program
+- You found a bug in the program
+- You have an idea about a nice feature this program lacks and you think it could be useful in a future release
+
+First of all you can find a list of known issues for this project [here](known-issues.md): check if the issue you are experiencing is among them.  
+If you can't find it or if the proposed solution does not work open this project's [GitHub issue page](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues/) and search among the issues (both open and closed ones, you can switch which you are viewing at the top, under the search bar) to verify that your problem/bug/idea has not been already submitted.  
+If you found an issue which applies to your situation and it has been closed, please read all the discussion thoroughly: it could contain the solution to your problem or an explanation about why the issue was closed. If the issue is still open instead feel free to contribute to the issue with your own experience: it will help everyone involved.  
+If you did not find any issue related to your case then you can submit a new issue by clicking on the green "New issue" button at the top of the page.
+
+**Important note:** if you want to comment on an issue or open a new one you will need to login with your GitHub account. If you don't have one you can register [here](https://github.com/join): it's a really quick procedure.
+
+### What to include in the issue?
+
+If you are reporting a problem or a bug, please include as much details as you can, for example:
+
+- Which version of the program are you using?
+- What happened when you experienced the problem? What were you expecting to happen instead?
+- Is this a recurring issue or a one-time event?
+- Have you tried anything to solve it? Have you had any form of success?
+
+#### Example of an useless issue
+
+> Title: **Program not working**
+> Message: The program does not work: I cannot use it correctly as it sometimes stops working.
+
+This description of the problem is exceptionally vague and offers little to no ground for the developers to work on to understand, isolate and solve the problem.
+
+#### Example of a useful issue
+
+> Title: **Program crashes when switching desktops**
+> Message: Since I installed the last version of the program sometimes as I switch desktops it crashes without giving any error message: it just shuts down (the icon in the tray bar disappears).  
+> Every time it has happened I was switching from the last to the first desktop, however it does not always happen: sometimes it will switch correctly and sometimes it will crash.
+
+This is a great description of the problem: the user reported many extremely useful information, such as a possible version number which introduced the bug, a meaningful description of what happens and an hypothesis on what action triggers the crash.  
+Obviously you will not always be able to give so much useful information, however _the more details you can report the better it is_.

docs/known-issues.md

@@ -0,0 +1,66 @@
+# Known issues
+
+This is a useful list of some of the most important issues reported for this project.  
+A brief description of the problem and of the available solutions or workarounds are collected here: please follow the links to the original issues to read all the details.
+
+For a complete list of all the issues reported for this project visit [this page](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues).
+
+## Table of contents
+
+- [Programs run as another user](#programs-run-as-another-user)
+- [Remote Desktop Protocol](#remote-desktop-protocol)
+- [Synergy and AutoHotkey](#synergy-and-autohotkey)
+- [Windows 10 Game Bar](#windows-10-game-bar)
+
+### Programs run as another user
+
+**Problem**:  
+Windows 10 Virtual Desktop Enhancer can have some difficulties when interacting with windows which are run with higher rights than the program itself.  
+[This comment on issue #21](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues/21#issuecomment-308504500) collects what is known about the interaction between this program and other programs run as other users; most importantly:
+
+- When running as a normal user Windows 10 Virtual Desktop Enhancer will not work when a program run as another user is focused
+- If your account is an administrator you should experience no problem at all, still if you do you can run WIndows 10 VIrtual Desktop Enhancer as administrator to solve those issues
+
+**Workaround**:  
+While no definitive solution to these problems can be provided as they are related to an external library used by this project, a simple workaround is to run Windows 10 Virtual Desktop Enhancer with administrative rights.  
+If you want to test this workaround follow these steps:
+
+- Right click on the executable or on the link
+- Click "Run as administrator"
+
+If you want it to always run with administrative rights floow these steps:
+
+- Right click on the executable or on the link
+- Click "Properties"
+- Select the "Compatibility"
+- Check "Run this program as an administrator"
+
+This will solve the issues at the cost of breaking the tray icon and tooltip functionalities, except if your account is an administrator.
+
+### Remote Desktop Protocol
+
+**Problem**:  
+In [issue #15](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues/15) an user reported that while connecting via RDP (Remote Desktop Protocol) to a remote machine running this application he experienced some trouble with hotkeys not being correctly transmitted to the remote machine and with the program not cahnging dekstops and wallpapers correctly.
+
+**Solution**:  
+There is no solution or workaround for this issue: if you experience similar problems you can report them in a new issue or in [issue #15](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues/15) if you believe it to be related.
+
+### Synergy and AutoHotkey
+
+**Problem**:  
+[Issue #41](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues/41) seems to suggest that AutoHotkey and [Synergy](https://symless.com/synergy) can conflict and prevent some hotkey combination from working correctly: in this particular issue it has been reported that it was not possible to issue more than one command holding down the modifier keys (e.g. `Ctrl + Win + Left + Left` to switch tow desktops to the left).
+
+**Solution**:  
+There is no solution or workaround for this issue even though many more similar issues regarding conflicts between these two programs can be found on the internet.
+
+### Windows 10 Game Bar
+
+**Problem**:  
+In [issue 57](https://github.com/sdias/win-10-virtual-desktop-enhancer/issues/57) an user reported how certain hotkeys in certain situations triggered a popup from Windows asking whether or not to start the Game Bar.  
+In particular any hotkey combination containing the `Alt` key alone or with other keys or any hotkey containing the `Win` key alone seem to cause this issue.
+
+**Workaround**:  
+Although it has not been possible to pinpoint exactly what the root cause of this bug is, there are two available workarounds:
+
+ - Disabling the Windows Game Bar (recommended if it's not used on your computer). [Here is a guide](https://www.howtogeek.com/273180/how-to-disable-windows-10s-game-dvr-and-game-bar/) explaining how to do it
+ - Not using the `Alt` key (neither alone nor with other keys) nor the `Win` key alone (it looks to be fine if used together with other keys) in your custom hotkeys setup (recommended if you want to use the Game Bar on your computer). See the [customization page](settings.md#keyboard-shortcuts) of this documentation for further details