Document `stbt.black_screen` in the official API doc

This updates `api-doc.sh` so that it generates documentation for the new
function `black_screen` and substitutes the default value for
`black_screen.threshold` from `stbt.conf` in the function's docstring.

This commit also adds the `README.rst` generated with `make doc`.