added documentation, enhanced access from external requires