copying the documentation branch of @sebulino as he didn't create a PR