Fix and update javadocs in KieBase

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