Umieszczenie dokumentacji Intellisense Xml w zestawie?

Question

Mam zestaw zawierający bardzo dokładną dokumentację opartą na XML, która jest używana przez Sandcastle do generowania plików pomocy dla produktu. Używamy również wyjściowych plików XML do zapewniania odpowiedniego IntelliSense w Visual Studio, gdy programiści w sposób oczywisty korzystają z tego zestawu.

W tym celu wydaje się, że zarówno dostarczamy użytkownikowi zestaw ("assembly.dll"), jak i dokumentację ("assembly.xml").

Czy w jakiś sposób można osadzić dokumentację w zespole, więc musielibyśmy dostarczyć tylko jeden plik-zestaw, a Visual Studio byłoby w stanie wyodrębnić informacje? Może osadzony jako zasób lub coś w tym stylu?

Answer 1

Niestety, będziesz musiał dostarczyć oba, ponieważ Visual Studio wie tylko, aby spojrzeć na dokumenty XML dla Intellisense.

Answer 2

Czy brakuje czegoś? Zawsze komentuję jak zwykle (za pomocą 3 ukośników lub 3 znaczników (vb)), użyj wbudowanych znaczników xml i kiedy używam zestawu, otrzymuję intellisense - rzadko korzystam z zewnętrznego pliku xml.

Answer 3

Jeśli wyszukasz C: \ Windows \ Microsoft.NET \ Framework \ v2.0.50727, zobaczysz, że wszystkie zestawy .net, do których odwołujesz się w swoich aplikacjach, używają plików xml. Visual Studio dostarczy tylko intellisense dla złożeń, jeśli plik xml istnieje. Na przykład, jeśli chcesz zamknąć program Visual Studio, a następnie usunąć plik System.Drawing.xml, a następnie ponownie otworzyć VS, nie powinno być żadnych intellisense dla tego zestawu. Następnie trzeba zamknąć VS, skopiować go, a następnie ponownie otworzyć VS, aby intellisense działał ponownie.