Bwaaaa... I didn't realize it was so meager -- I also thought it was borked.
And it's a mod I'd install!
Totally! On the other hand, I'd like the ability to have a hand in the workshop's success (or failure!) in some way or another.
I don't disagree with you, Ragnargh, but actually I think you might be underestimating the work it would take -- I think you're right that the actual writing wouldn't be hard. Also, I bet Clanker's probably right, a robust explanation most mechanics will probably eventually exist. But in the meantime, writing up an explanation of every mechanic, its intended consequences and costs, making sure it's accurate and written well, and that whenever updates happen every corresponding mechanic is also up-to-date and nothing gets missed costs time. And that's time a dev could be spending actually making the changes.