add comments about value objects