improved getter/setter section

@geshan @namshi/backend-read updated the doc as per last discussions