C# xmldoc на страницу документации
Фон:
Недавно я использовал Swagger для проекта WebAPI, и мне нравится документация и ее включение в документацию XML, которую я использую в своих методах. У меня есть другие проекты, не относящиеся к WebAPI, для которых я хотел бы создать документацию. Я знаю, что песочный замок существует, и я использовал его ранее, но он больше не поддерживается. Есть поддерживаемая вилка (вилка, похоже, не сильно отличается от оригинала). Кроме того, это не самая красивая вещь на планете для использования (или что она генерирует). Ранее я использовал вывод, и Google быстро понизил рейтинг за то, что я не поддерживал мобильный контент.
Вопрос:
Есть ли другие генераторы документации, которые делают современные веб-сайты, которые хорошо масштабируются на настольных и мобильных устройствах? Я просто вынужден делать документацию вручную?
Пожалуйста, прекратите помечать это как дубликат Как создать сайт из комментариев документации XML?, Я хорошо знаю этот вопрос, однако ему четыре года, и, как мы все знаем, в течение четырех лет произошли значительные изменения в технологии. Я ищу актуальную информацию.
1 ответ
DocFX позволяет очень легко комбинировать сгенерированную и ручную документацию
https://dotnet.github.io/docfx/
Он был разработан Microsoft для замены портала документации MSDN и сделан с открытым исходным кодом.