I've started running a MythTV box for my television viewing pleasure. Specifically, I'm running KnoppMyth.

MythTV is a very nice product despite its perpetual alpha state. But it has one really big flaw — virtually all the documentation is installation instructions. There is little to no documentation on the user interface.

I admit that most of the idea is fairly straight forward and the UI mostly does sensible things. But the gap between the sensible things and the other things is severe.

In my case, I really want to understand how the scheduler makes its decisions. Not because I'm not trusting its behavior, but because I'm spending too much time overriding the decisions. I know that you can tune the scheduler with a large variety of priority settings. But to do that effectively, I need to understand the program. Otherwise I'll have to learn it by trial and error, which is a slow process at best.

Not being one to just piss and moan (though I'm perfectly willing to do at least that), I've started creating the documentation for the UI. One weekend of work and I have the Web interface roughed out. But only for the TV functions, which is my primary interest. I started with the web interface because I could edit the docs at the same time as I played with the interface.