remove redundant method from optionset
suppress missing xml doc warnings
should use paramref  not param in docs
fix invalid xml docs