Archiwa tagu: ASP.NET Web API

Help Api i komentarze

Jak dodać do aplikacji asp.net api HELP PAGES, można znaleźć np. na stronie asp.net.

Co więcej bym chciał do tego dodać? Obsługę kilku providerów. Nic więcej – to co jest w dokumentacji odnośnie dokumentacji po prostu działa.

Tylko… co jeśli macie oddzielny projekt na modele do Web API? Ano nic.

W naszej automatycznie wygenerowanej dokumentacji nie będzie żadnych komentarzy z tegoż właśnie projektu. Nie dziwota, przecież ładujemy tylko jeden plik xml:

Fajnie by było móc ustawić provider z kilkoma plikami XML. Np. tak:

Wystarczy tylko dodać nowy konstruktor do klasy XmlDocumentationProvider:

Powyższy kawałek kodu znalazłem na stacku.  Po zastosowaniu możesz cieszyć się REST API z komentarzami z osobnej assembly.