UPDATING
From FreeBSDwiki
/usr/src/UPDATING is the location of the file describing all the current information needed to upgrade a system properly from source. Sometimes special procedures are needed due to recent changes in the system such as the addition of new user groups. Reading the top sections of this file is very important to successfully upgrading, and many upgrade failures are a result of users skipping this step. See also /etc/make.conf