JDoc, explicit immutability in method responses and cleaning up some
warnings