Описание приватной переменной, как здесь:
/**
* the name of this object.
*/
private String name;
... не должно содержать описания своих методов получения и установки. Он должен содержать свойства этой переменной, инварианты (например, никогда не должны иметь значение null ) и тому подобное.
Edit:
Ах, я неправильно понял ваш вопрос. Вы спросили, почему описание методов получения / установки должно содержать описание переменной, а не наоборот.
Они не должны - там даже не должно существовать такой переменной. Получатели и установщики должны описывать эффект, который они оказывают, который может включать модификацию (или извлечение) некоторого абстрактного свойства этого объекта. То, что это свойство реализовано частной переменной, не имеет значения.