update docs and mirror bug fix