add new descriptions and fix comments