Add a bit of insight on that method in the form of javadocs. Done for
now.