completed descriptor documentation