Finished code documentation and explanation of the problem in the README
file.