document code validation mechanism
merge