[NUCCORE-1099] Add fallback and associated LOG message about API. Much
improved javadocs