Fix .gitignore and documentation

doc/README.md

@@ -2,6 +2,13 @@
 
 The documentation is published through the `gh-pages` branch.
 
-To publish the documentation, do:
+To publish the documentation, you need to clone the `gh-pages` branch of this repository into
+`docs/gh-pages`. In `docs`, do: 
 
     git clone -b gh-pages git@github.com:larsimmisch/pyalsaaudio.git gh-pages
+
+Once that is setup, you can publish new documentation using:
+
+    make publish
+
+Be careful when new files are generated, however, you will have to add them manually.