starting from AEM 6.5 Adobe provides two types of uber-jar: regular and with deprecated api. Looking at AEM docs I can see that com.day.cq.dam.scene7,Scene7Service has been marked as deprecated and we're instructed to use com.day.cq.dam.scene7.api.Scene7Service.
However neither of packages listed in uber-jar-apis (whereas I expected com.day.cq.dam.scene7.api.Scene7Service to be there). Nevertheless it could be found in uber-jar-apis-with-deprecations. Which makes me wonder why would Adobe deprecate actual API.
Could anyone suggest what's been marked as the replacement though?
The Scene7 API jar was included in the deprecated jar package because it contains deprecated methods. For the foreseeable future, the com.day.cq.dam.scene7.api.Scene7Service package is the correct one to use.