Чем спецификация отличается от документации в JAVA?

Question

[private_tm]

docs.oracle.com/javase/8/docs/api/index.html что это спецификация или документация?
Для чего существует спецификация и документация?
Чем пользоваться при разработке?
По какому адресу можна найти спецификацию?

Answer 1

[Евгений]

Спецификация - это сухое описание продукта или подхода. ТТХ если хотите. Документация же может содержать советы по применению продукта основанного на спецификации, или наоборот совету по не применению.

По ссылке, которую Вы привели находится спецификация API 8 JDK.

При разработке пользуются в основном гуглом, чтоб найти документацию. К спецификации прибегают в крайне запутанных случаях, например когда мы делаем свою реализацию API чего либо, и нам нужно придерживаться спецификации.

Спецификация языка Java есть по такому адресу: https://docs.oracle.com/javase/specs/.

ИМХО, понять ее не в состоянии даже те, кто ее написал)

Comments

[private_tm]

аха а я уже начал ее читать)

Answer 2

[private_tm]

Спецификация языка docs.oracle.com/javase/specs/jls/se8/html/index.html

Документация
docs.oracle.com/javase/8/docs/api/index.html

Answer 3

[Игорь Астахов]

Спецификация - описание того, как нужно делать.
Документация - описание того, что уже сделано.

На пример у нас есть две различных JDK - oracle и open. Все они реализуют одни и теже спеки, но подходы в реализации могут отличаться. Но в обоих случаях мы можем быть уверены, что
String s = "hello " + "world";
нам вернёт фразу целиком, а не попробует сложить значения в матиматическом смысле