expanded documentation on intialization