documenting function changes