updating documentation: #MSG-311 In Progress