begin expansion, add documentation