improve code documentation