* improve KeyBuilder documentation

* clarify slightly

* Tweak docs, add types

---------

Co-authored-by: Andreas Kloeckner <inform@tiker.net>