Ignore (suggested) docs dir -- not just html (#68)

* Ignore (suggested) docs dir -- not just html

* Improve writing

.gitignore

@@ -143,7 +143,7 @@ cython_debug/
 .idea/
 
 #documentation
-*.html
+docs-generated/
 
 # mergetoolfiles
 *.orig

docs/dev_guide.md

@@ -25,8 +25,8 @@ To *live preview* your changes, do
 pdoc -t docs/templates --docformat=numpy --math pipt popt misc ensemble simulator input_output docs/dev_guide.py docs/tutorials.py
 ```
 
-This will probably open a browser window with the rendered html.
-You can also ctrl/cmd-cick the printed localhost link, or simply copy-paste it into your browser.
+This should open a browser window with the rendered html.
+You can also ctrl/cmd-click the printed localhost link, or simply copy-paste it into your browser.
 
 If you want to reproduce errors that occur in **CI**, you'll want to include the option `-o docs-generated `.
 Since this actually generates html *files*, it will processes **all** of the files by default
@@ -36,12 +36,12 @@ Since this actually generates html *files*, it will processes **all** of the fil
   (it simply quits with a traceback).
   We therefore use my (`patnr`) fork which
 
-  - skips the markdown conversion,
+  - skips the markdown conversion for the erroneous docstring,
   - prints the specific docstring that causes issues.
 
 ## Tests
 
-Th test suite is orchestrated using `pytest`. Both in **CI** and locally.
+The test suite is orchestrated using `pytest`. Both in **CI** and locally.
 I.e. you can run the tests simply by the command
 
 ```sh