Чем спецификация отличается от документации в JAVA?
Спецификация - это сухое описание продукта или подхода. ТТХ если хотите. Документация же может содержать советы по применению продукта основанного на спецификации, или наоборот совету по не применению.
По ссылке, которую Вы привели находится спецификация API 8 JDK. 
При разработке пользуются в основном гуглом, чтоб найти документацию. К спецификации прибегают в крайне запутанных случаях, например когда мы делаем свою реализацию API чего либо, и нам нужно придерживаться спецификации.
Спецификация языка Java есть по такому адресу: https://docs.oracle.com/javase/specs/.
ИМХО, понять ее не в состоянии даже те, кто ее написал)
Спецификация языка docs.oracle.com/javase/specs/jls/se8/html/index.html
Документация
docs.oracle.com/javase/8/docs/api/index.html