revert patch for #1210 as @iocanel has a better solution - also added better java container docs