add notes on value retrieval