updates to the porting guidelines documents