updating docs and FIXMEs