add documenting comments