README extended with notes about changes within this refactoring and rules that apply to it.