docs: finish first round on the repository chapter