improved DEBUG docs