more changes necessary for developer documenation