ARQGRA-338: fix & generate JavaDoc for API and SPI