improve java docks on logic classes