I addressed the "getSomething" aspect here and I like what you presented. JavaDocs will be addressed in a separate PR when I sweep through all of the code.