validate

validated full doc. please merge into opaque_ns master