improved code documentation