Я документирую своих учеников в VS 2010 с атрибутом Summary. Когда я собираю проект, файл XML - это сборка (я буду использовать его позже при разработке). Одно из резюме участника класса не включено в XML-файл, вместо этого появляется сообщение об ошибке «Плохо сформированный XML-комментарий игнорируется для участника».
Сводка текста ниже. Я не понимаю, что форматируется неправильно. Должен ли я экранировать символ &
и использовать вместо него %26
?
/// <summary>
/// URI of a web page to convert. Must start with http:// or https://. Several URI of web pages can be passed to create one PDF. For example if http://www.google.com+http://www.nytimes.com URI will be passed the two web pages will be merged into one PDF.
/// If URI has special characters like ? or & they must be encoded.
/// </summary>