Debug builds enable Py_DEBUG

- Not sure if this is really what I want, but I'll keep it for now
Enable release mode by default
Update documentation