Comments 6
Выглядит ужасно: вместо документации метода мы видим абсолютно бесполезный header веб-страницы.
Так в том то и дело, что это не просто документация по конректному методу, а веб-страница с полной документацей (перегрузки, примеры кода на разных языках, просмотр в других версиях фрейморка, замечния и полезные ссылки). Просто эта страница открывается не в браузере, а прямо в студии.
То, что Вы приводите, в студии можно просто увидеть в попапе при наведении курсора или в ителлисайнсе.
Суть в том, что большая часть выводимой информации (header, меню) просто бесполезно занимает место в окне, где у меня вообще-то предполагается код, а до описания метода приходится ещё и скроллить. Так что было бы неплохо это хоть как-то оптимизировать.
Например в этом конкретном случае можно вспомнить что html5-compliant страница должна содержать основной контент в теге <article> и выводить собственно только её, ну или выводить весь <main> если там тоже есть какая-то полезная информация. Вообще, в идеале было бы попросить коллег из отдела msdn вообще зафигачить отдельный view для отображения контента во встраиваемых компонентах или в iframe. Частый кейс ведь. Продакты из мс так не думают?
И вот оно всё такое. Я пользуюсь PPT примерно начиная с VS2013, но добрая половина тулов при великолепных идеях имеют полностью убитую реализацию.
Например в этом конкретном случае можно вспомнить что html5-compliant страница должна содержать основной контент в теге <article> и выводить собственно только её, ну или выводить весь <main> если там тоже есть какая-то полезная информация. Вообще, в идеале было бы попросить коллег из отдела msdn вообще зафигачить отдельный view для отображения контента во встраиваемых компонентах или в iframe. Частый кейс ведь. Продакты из мс так не думают?
Можно просто показывать markdown с гитхаба, где и хранится вся документация. Скорее всего просто нет удобного механизма для её получения. А переход на веб-доку был всегда и ручка для этого не менялась уже лет 15
В VS мы увидим то же, если просто навести на семантический символ (тип, метод, т. д.).
Пользуюсь уже давно, всем рекомендую.
Повысьте свою продуктивность с помощью расширений Productivity Power Tools в Visual Studio 2022