add element descriptions and fix errors