Generowanie dokumentacji kodu wbudowanego przy użyciu GitHub Copilot

Prawidłowe dokumentowanie kodu powoduje utworzenie bardziej czytelnej i konserwowalnej bazy kodu, która jest łatwiejsza dla innych deweloperów do zrozumienia i pracy z.

Usługa GitHub Copilot Chat ułatwia szybkie, dokładne i spójne dokumentowanie kodu.

Każda z następujących funkcji GitHub Copilot może służyć do tworzenia dokumentacji kodu wbudowanego:

• Widok czatu: użyj widoku czatu w trybie Zapytaj, Agenta lub Planu.
• Czat wbudowany: użyj wbudowanej sesji czatu, aby udokumentować określony kod (klasy, metody lub bloki kodu) bez opuszczania edytora.

Generowanie dokumentacji kodu wbudowanego przy użyciu widoku czatu

Widok czatu może służyć do generowania wbudowanej dokumentacji kodu dla projektu, pliku kodu, klasy lub metody. Przed zaktualizowaniem pliku kodu możesz przejrzeć sugerowaną dokumentację i zażądać aktualizacji zgodnie z potrzebami.

Każdy z trzech trybów widoku czatu (Ask, Agent i Plan) może służyć do generowania dokumentacji kodu wbudowanego. Koszt korzystania z trybu agenta jest wyższy niż inne tryby, które mogą być brane pod uwagę.

Generowanie dokumentacji kodu wbudowanego przy użyciu widoku czatu w trybie zapytaj

Tryb zapytaj może służyć do oceny kodu i sugerowania wbudowanej dokumentacji kodu dla projektów, klas lub metod. Możesz przejrzeć sugerowaną wbudowaną dokumentację i wygenerować aktualizacje zgodnie z potrzebami przed dodaniem dokumentacji do pliku kodu.

1. Otwórz widok Czat w trybie zapytaj.

2. Dodaj kontekst do monitu czatu. Na przykład dodaj plik markdown zawierający wskazówki dotyczące dokumentacji.

3. Wprowadź monit o wygenerowanie dokumentacji kodu wbudowanego. Możesz na przykład wprowadzić następujące polecenie:

   Suggest inline code documentation for the ConsoleApp class.
   

4. Przejrzyj sugerowaną dokumentację kodu wbudowanego w widoku czatu.

   

5. Gdy jesteś zadowolony z proponowanej dokumentacji, możesz wprowadzić ją do odpowiedniego pliku kodu.

   Umieść wskaźnik myszy na sugerowanej dokumentacji, aby wyświetlić przyciski Zastosuj w edytorze, Wstaw w kursorze i Kopiuj . Przycisk Zastosuj w edytorze służy do stosowania sugerowanej dokumentacji do pliku kodu.

   Możesz użyć przycisku Wstaw przy kursorze , aby wstawić sugestię do edytora w bieżącym położeniu kursora lub przycisk Kopiuj , aby skopiować sugestię do schowka.

6. Po zastosowaniu sugerowanej dokumentacji do pliku kodu możesz przejść przez aktualizacje, aby zaakceptować, odrzucić lub zmodyfikować poszczególne sugestie.

   

   Użyj strzałek w górę i w dół na dolnym pasku menu, aby przejść przez sugerowane aktualizacje.

   Przechodząc przez sugestie, możesz zachować lub cofnąć poszczególne z nich za pomocą menu podręcznego, które wyświetla się po najechaniu kursorem na sugestię.

   Możesz również ręcznie modyfikować sugestie zgodnie z potrzebami.

7. Aby zaakceptować lub odrzucić wszystkie sugestie, wybierz przycisk Zachowaj lub Cofnij na dolnym pasku menu.

   Możesz kontynuować aktualizowanie dokumentacji zgodnie z potrzebami w edytorze kodu.

Generowanie dokumentacji kodu w linii przy użyciu widoku czatu w trybie Planowania

Widok czatu w trybie planu może służyć do utworzenia szczegółowego planu generowania dokumentacji kodu wbudowanego w projekcie. Tryb planu analizuje bazę kodu i tworzy plan krok po kroku, który można przekazać do trybu agenta na potrzeby wykonywania.

1. Otwórz widok Czat w trybie planu.

2. Wprowadź monit opisujący wbudowane zadania dokumentacji.

   Możesz na przykład wprowadzić następujące polecenie:

   Create a plan for adding inline code documentation to the codebase. Document classes, properties, and methods. Identify all files that need documentation updates.
   

3. Zapoznaj się z planem implementacji.

   Po kilku chwilach agent planu wyświetli plan w widoku czatu. Plan zawiera wysokopoziomowe podsumowanie i podział kroków, w tym wszelkie otwarte pytania do wyjaśnienia.

4. Po zakończeniu planu wybierz pozycję Rozpocznij implementację , aby przekazać plan do trybu agenta, lub wybierz pozycję Otwórz w edytorze , aby zapisać plan jako plik Markdown do późniejszego użycia.

   Po wybraniu Start Implementation GitHub Copilot przełącza się do trybu agenta i rozpoczyna dodawanie dokumentacji kodu wbudowanego na podstawie zatwierdzonego planu.

5. Przejrzyj zaktualizowane pliki w edytorze. Przejdź przez aktualizacje, aby zaakceptować, odrzucić lub zmodyfikować poszczególne sugestie.

6. Aby zaakceptować lub odrzucić wszystkie sugestie, wybierz przycisk Zachowaj lub Cofnij na dolnym pasku menu. Możesz również wybrać przyciski Zachowaj lub Cofnij w widoku Czat, aby zaakceptować lub odrzucić wszystkie sugestie.

   Możesz kontynuować aktualizowanie dokumentacji zgodnie z potrzebami w edytorze kodu.

Generowanie dokumentacji kodu wbudowanego przy użyciu widoku czatu w trybie agenta

Widok czatu w trybie agenta może służyć do generowania dokumentacji kodu wbudowanego dla projektu, pliku kodu, klasy lub metody. Przed zaktualizowaniem pliku kodu możesz przejrzeć sugerowaną wbudowaną dokumentację i zażądać aktualizacji zgodnie z potrzebami.

1. Otwórz widok czatu w trybie agenta.

2. Dodaj kontekst do monitu czatu. Na przykład użyj przycisku Dołącz kontekst (ikona spinacza), aby dodać foldery kodu źródłowego do czatu.

3. Wprowadź monit definiujący zadania dokumentacji.

   Możesz na przykład wprowadzić następujące polecenie:

   Create inline code documentation for all C# class files in the specified context. Document the class, properties, and methods. Do not add documentation to JSON, markdown, or other file types. Do not document UnitTest project files in the Test folder. Ensure that the solution builds without errors after the documentation is added.
   

4. Agent wyświetla komunikaty o stanie w widoku Czat podczas wykonywania żądanych zadań.

   

   Agent może również zażądać więcej kontekstu lub poprosić o pomoc w celu wykonania żądanych zadań. Na przykład agent może poprosić o uprawnienie przed uruchomieniem polecenia w terminalu.

5. Poczekaj na ukończenie żądanych zadań dokumentacji przez agenta, a następnie przejrzyj zaktualizowane pliki edytora.

   

   Po zakończeniu trybu agenta zostanie wyświetlone podsumowanie ukończonych zadań. Zaktualizowane pliki można przejrzeć w edytorze.

6. Przejdź przez aktualizacje, aby zaakceptować, odrzucić lub zmodyfikować poszczególne sugestie.

   Aby zaakceptować lub odrzucić wszystkie sugestie, wybierz przycisk Zachowaj lub Cofnij na dolnym pasku menu. Możesz również wybrać przyciski Zachowaj lub Cofnij w widoku Czat, aby zaakceptować lub odrzucić wszystkie sugestie.

   Możesz kontynuować aktualizowanie dokumentacji zgodnie z potrzebami w edytorze kodu.

Generowanie dokumentacji kodu wbudowanego przy użyciu wbudowanego czatu

Funkcja czatu wbudowanego może służyć do generowania wbudowanej dokumentacji kodu dla klas, metod lub złożonych bloków kodu. Monit służy do określania kontekstu lub podawania określonych instrukcji.

Czat w linii proponuje dokumentację kodu w linii bezpośrednio w edytorze kodu.

1. Otwórz plik kodu w edytorze.

2. Wybierz kod, który chcesz udokumentować.

3. Rozpocznij wbudowaną sesję czatu.

   Użyj skrótu klawiaturowego Ctrl+I lub wybierz pozycję Otwórz czat wbudowany z menu Czat .

4. Wprowadź monit o wygenerowanie dokumentacji kodu wbudowanego.

   Możesz na przykład udokumentować metodę i zażądać określonych szczegółów:

   Document the selected method. List currentState options
   

5. Przejrzyj sugerowaną dokumentację kodu wbudowanego w edytorze.

6. Użyj przycisku Zachowaj, aby zaakceptować sugerowaną aktualizację, lub przycisku Cofnij, aby ją odrzucić.

Podsumowanie

GitHub Copilot ułatwia szybkie i dokładne generowanie dokumentacji kodu wbudowanego. Widok czatu i wbudowane funkcje czatu zapewniają różne poziomy interakcji bezpośrednio w środowisku Visual Studio Code.