Yes, the documentation can be improved, we're working on it as we speak 🙂 I think it's ok not to repeat everything on every page, but at least some links with additional information would be nice