Fix and update javadocs in KieBase

Fixed copy & paste errors in javadocs.
Minor updates to the javadocs:
 - using @link when appropriate
 - multiple small updates/enhancements