document inheritance where it belongs!
(sorry @FroMage)