added some docblock comments