Fix and revise docs for simulation framework