ADD: new logistics javadoc
FIX: some md links (add .html)