How can acrolinx improve the docs

We started discussing this at the conference and came up with a list of areas in the documentation that could be improved. Please add additional ideas/suggestions here. The nice folks over at IBM are going to go over to Germany to help improve the docs and your ideas will help them.