Improve the documentation

Fix some typos and fix the Debian description.