added documentation: API documentation augmented