Please please don not make the same mistake as the others when writing a manual for this great new feature.
I'll take that advice since I am aware of the fact that the current setup is not that easy to install as it should be. But please also take into account the complexity of the problem. You have tons of different devices which all speak their own protocols, you have different operating systems, different communication protocols (ASCOM and INDI), and different reference implementations of these protocols (ASCOM on windows and INDI on Linux/OSX).
INDI and ASCOM are a first step in simplifying this complexity by providing a layer that is independent of the vendor specific device control protocols. But both technologies are locked to different OS: ASCOM on Windows (it is written in .Net) and INDI (the server part) on Linux/OS.
I choosed INDI since it better supports the PI platform coverage and it is written in C/C++ which is easier to intergrate into PI. The drawback of that decision is the more complex installation for Windows users.