add some more documentation

compile_po task hasn’t been documented, yet. Also a reference to the specs
might be helpful for new users, because these contain some working examples.