readme, and updated some docs in extended