docs updates¯(°_o)/¯