Improving the documentation with background on the patterns involved