updating documentation: #MSG-290 In Progress