From 2f2b6dbb3d21b2946df8f06d046ef4c1531c9210 Mon Sep 17 00:00:00 2001 From: Giorgio Bonvicini Date: Sat, 8 Jul 2017 10:07:49 +0200 Subject: [PATCH] Improved the documentation. Replaced TOCs with auto-generated ones and added TOCs where missing. Added a link to the README in each page to improve navigation in offline documentation (in particular if converted into HTML - see #70). --- docs/installation.md | 16 ++++++++++++++++ docs/issue-page.md | 28 +++++++++++++++++++++++----- docs/known-issues.md | 18 ++++++++++++++---- docs/settings.md | 40 ++++++++++++++++++++++++++++++++-------- 4 files changed, 85 insertions(+), 17 deletions(-) diff --git a/docs/installation.md b/docs/installation.md index c928be7..5e97051 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -1,5 +1,19 @@ # Installation + + +- [Installation](#installation) + - [Prerequisites](#prerequisites) + - [Procedure](#procedure) + - [Autostart](#autostart) + - [Procedure 1: Autostart folder](#procedure-1-autostart-folder) + - [Procedure 2: Task scheduler](#procedure-2-task-scheduler) + - [Request assistance](#request-assistance) + + + +Click here to go back to the [README](../README.md). + ## Prerequisites **This application only works on Windows 10 x64 (64 bit) systems** due to limitations in the library used to control the virtual desktops. @@ -46,3 +60,5 @@ Please try the first procedure: if it does not work try the second one. ## 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). + +Click here to go back to the [README](../README.md). \ No newline at end of file diff --git a/docs/issue-page.md b/docs/issue-page.md index ea782b0..2ce3ccb 100644 --- a/docs/issue-page.md +++ b/docs/issue-page.md @@ -1,4 +1,20 @@ -# Issue page: what is it? +# Issue page + + + +- [Issue page](#issue-page) + - [Issue page: what is it?](#issue-page-what-is-it) + - [Windows 10 Virtual Desktop Enhancer's issue page](#windows-10-virtual-desktop-enhancers-issue-page) + - [When should I open a new issue?](#when-should-i-open-a-new-issue) + - [What to include in the issue?](#what-to-include-in-the-issue) + - [Example of an useless issue](#example-of-an-useless-issue) + - [Example of a useful issue](#example-of-a-useful-issue) + + + +Click here to go back to the [README](../README.md). + +## 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. @@ -8,7 +24,7 @@ Its main use is to submit bugs and problem found while using the program, but, d [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? +## When should I open a new issue? If you have found yourself in any of these situations: @@ -23,7 +39,7 @@ If you did not find any issue related to your case then you can submit a new iss **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? +## 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: @@ -32,14 +48,14 @@ If you are reporting a problem or a bug, please include as much details as you c - 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 +### 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 +### 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). @@ -47,3 +63,5 @@ This description of the problem is exceptionally vague and offers little to no g 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_. + +Click here to go back to the [README](../README.md). \ No newline at end of file diff --git a/docs/known-issues.md b/docs/known-issues.md index eee2a88..aae7bdd 100644 --- a/docs/known-issues.md +++ b/docs/known-issues.md @@ -7,10 +7,18 @@ For a complete list of all the issues reported for this project visit [this page ## 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) + + +- [Known issues](#known-issues) + - [Table of contents](#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) + + + +Click here to go back to the [README](../README.md). ### Programs run as another user @@ -64,3 +72,5 @@ Although it has not been possible to pinpoint exactly what the root cause of thi - 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 + +Click here to go back to the [README](../README.md). \ No newline at end of file diff --git a/docs/settings.md b/docs/settings.md index 8341992..7c04dde 100644 --- a/docs/settings.md +++ b/docs/settings.md @@ -5,14 +5,36 @@ Mainly you will have to edit some lines in the `settings.ini` file in the main f ## Table of contents -- [Main settings](#main-settings) -- [Custom wallpapers](#custom-wallpapers) -- [Desktop names](#desktop-names) -- [Tooltips](#tooltips) -- [Keyboard shortcuts](#keyboard-shortcuts) -- [Run programs when switching desktops](#run-programs-when-switching-desktops) -- [Tray icon](#tray-icon) -- [Old settings migration](#old-settings-migration) + + +- [Personalize the settings](#personalize-the-settings) + - [Table of contents](#table-of-contents) + - [Main settings](#main-settings) + - [Custom wallpapers](#custom-wallpapers) + - [Image wallpapers](#image-wallpapers) + - [Solid color wallpapers](#solid-color-wallpapers) + - [Example configuration](#example-configuration) + - [Desktop names](#desktop-names) + - [Example configuration](#example-configuration-1) + - [Tooltips](#tooltips) + - [Example configuration](#example-configuration-2) + - [Keyboard shortcuts](#keyboard-shortcuts) + - [Available shortcuts](#available-shortcuts) + - [Keyboard shortcuts modifier keys](#keyboard-shortcuts-modifier-keys) + - [Keyboard shortcuts identifier keys](#keyboard-shortcuts-identifier-keys) + - [Keyboard shortcuts combinations](#keyboard-shortcuts-combinations) + - [Example configurations](#example-configurations) + - [Default configuration](#default-configuration) + - [Custom configuration](#custom-configuration) + - [Run programs when switching desktops](#run-programs-when-switching-desktops) + - [Example configuration](#example-configuration-3) + - [Tray Icon](#tray-icon) + - [Icon Packs](#icon-packs) + - [Old settings migration](#old-settings-migration) + + + +Click here to go back to the [README](../README.md). ## Main settings @@ -408,3 +430,5 @@ NextTenDesktops= PreviousDesktop=Left NextDesktop=Right ``` + +Click here to go back to the [README](../README.md). \ No newline at end of file