fix some notices and add descriptions to new fields