I've been playing DF for several months, and lurking on the forum for about as long, but I registered just to post to this thread.
I love roguelikes, and I love turn-based strategy games like Civ II & III. When I heard about DF, I was stoked. So I downloaded it, but was so put off by it, I uninstalled it in disappointment.
My problems:
I. User Interface issues: Inconsistent and non-intuitive commands.
* Selection process: Sometimes you use +/- to scroll, sometimes 8/2. Sometimes ENTER selects, sometimes SPACE, and sometimes F9. For that matter, sometimes SPACE selects a choice, and sometimes it cancels a choice. ESCAPE never escapes the current menu, it escapes the *game*. Recommendation: SPACE and ENTER do the same thing (as in many other games) and ESCAPE goes back one choice. Unify scrolling where possible. (I think the requests for the next merchant caravan screen is the only place where it wouldn't work to unify it.)
* Viewing process: loo[k] views a square. But [t] views the contents of a workshop, [q] views the production queue of a workshop, and [v] views the status of a dwarf. I love roguelikes, so I wasn't put off by the ASCII graphics - but the basic tool for understanding what I was seeing, the "examine" command (as ZAngband calls it), wasn't doing what I needed it to do. The view command is the most basic tool for learning the game, and if there was a unified viewing command, I could have figured much more of the game out myself.
II. Gameplay issues: I had no idea what to do, or how. The in-game documentation was less than helpful. The only thing it taught me was that sometimes I use SPACE where I would expect to use ESCAPE.
What got me back in to play the game? I read Boatmurdered, which is currently the best marketing tool the game has, and I was pointed to the wiki, which contained a simple tutorial. Really, the tutorial was what did it. If you do nothing else, put a brief note on the title screen saying "Beginner tutorial available at:" and give the URL for the wiki's Your First Fortress.
Ragnar