Improve the documentation per @esacteskab's review