fixed minor validation issues with form
added doc clarifications
merged