extended documentation on key generators