some docs translation and code