Adding KNOWN ISSUES

Author: Lisias

KNOWN_ISSUES.md

@@ -0,0 +1,71 @@
+# Module Manager Watch Dog :: Known Issues
+
+This is a troubleshot list to help you fixing your instalment.
+
+
+## Known detectable problems
+
+If you need help about how to fix your system, drop me a message on [Forum](https://forum.kerbalspaceprogram.com/index.php?/profile/187168-lisias/) or send me a email using the address `support` **at** `lisias` **dot** `net` . Please add "KSP:ModuleManagerWatchDog" as the subject of the email, or my email filter will not detect your email and I may miss it.
+
+### There're more than one MM Watch Dog on this KSP instalment!
+
+Well, somehow you managed to have installed more than one copy of this tool itself!
+
+Check `GameData/` for DLLs with the name "ModuleManagerWatchDog" on it and delete all of them - but the newest one.
+
+### "There's no Module Manager on this KSP instalment!"
+
+Well, you need to install Module Manager! :) See the "How-To" below.
+
+Check `GameData/` for DLLs with the name "ModuleManager" on it and delete all of them - but the newest one.
+
+###  "There're more than one Module Manager on this KSP instalment!"
+
+Unfortunately, from KSP 1.8.0 and above a fatal bug is affecting Module Manager when mode then one MM dll is installed on your system, what renders Module Manager choosing to use the **oldest** version to be used. This caused some problems to TweakScale at least one.
+
+There's no other solution available but to **DELETE** all redundant copies of Module Manager, leaving only one on the GameData. 
+
+This was diagnosed on [TweakScale's thread](https://forum.kerbalspaceprogram.com/index.php?/topic/179030-ksp-141-tweakscale-under-lisias-management-24314-2020-0519/&do=findComment&comment=3797945).
+
+## How-To install Module Manager
+
+You have two options, each one with advantages and drawbacks.
+
+### Option I : Module Manager /L Experimental
+
+This is my personal fork of Module Manager, aiming to fix some non functional bugs while keeping compatibility with the original Module Manager.
+
+* Advantages
+	+ Slightly faster, mainly on systems with less memory
+	+ Way better logging
+		- But still lacking a thing or two. 
+	+ Some fix from small annoyances or bugs, as long it doesn't breaks compatibility with the upstream. 
+	+ It works on every KSP Version from 1.4.x to the latest
+		- KSP 1.3.1 and 1.2.2 are work in progress, to be released soon.
+* Disadvantages
+	+ It's not supported by most of the Add'On authors
+		- To tell you the true, I'm the only one supporting this stunt. :)
+	+ Some Add'On authors may dismiss your bug reports by using a non "official" Module Manager.
+	+ It has dependencies.
+
+If you are willing to risk your SAS, you can downloaded it from my github:
+
+* [Module Manager /L Experimental](https://github.com/net-lisias-ksp/ModuleManager/releases)
+* Dependencies
+	+ [KSPe and KSP API Extensions](https://github.com/net-lisias-ksp/KSPAPIExtensions).
+
+### Option II : Official Module Manager
+
+Obviously, you can use the Official Module Manager from Forum.
+
+* Advantages
+	+ Lower risk of being your reports rejected by using non Official versions of something
+* Disavantages
+	+ Less conveniency on diagnosing problems using the logs
+	+ Some annoying misfeatures
+	+ You need to cope with this type of [bad behaviour](https://forum.kerbalspaceprogram.com/index.php?/topic/50533-18x-19x-module-manager-413-november-30th-2019-right-to-ludicrous-speed/&do=findComment&comment=3742972). :(
+		- Yeah, it was moderated, so...
+			-  ![One](./Screen%20Shot%202020-02-18%20at%2008.59.14.png)
+			-  ![Two](./Screen%20Shot%202020-02-18%20at%2008.59.21.png)
+
+To download it, go to [Forum](https://forum.kerbalspaceprogram.com/index.php?/topic/50533-18x-19x-module-manager-413-november-30th-2019-right-to-ludicrous-speed/&tab=comments#comment-720814).