add descriptions for conf & shell