@rysiek It's a good idea. I think well written and easily digestible documentation is really important for software, especially when it's on the technical side.
While some users may be able to quickly grasp what's going on, others may be put off if they can't get to grips with how to use it. It's a fine balance, I suppose.
If I have any other broader suggestions while I'm looking through it, I'll be sure to let you know.