finished section 3 docs, apart from references