improved getter/setter section

@geshan @namshi/backend-read updated the doc as per last discussions
what does the second sentence mean? I dont understand :)