update docs with faq fixes.