문서 정리 (#11)

* 문서 업데이트

* 문서 업데이트

Author: justinyoo

README.md

@@ -11,11 +11,13 @@ GitHub Copilot의 최신 기능을 이용해서 다양한 언어로 다양한 
 
 ## 워크샵 사전 준비사항
 
-GitHub Codespaces를 활용할 경우, 크로미움 계열의 웹 브라우저만 있으면 됩니다. 다만, 로컬 PC에서 직접 개발할 경우, 아래와 같은 내용을 준비해야 합니다.
+GitHub Codespaces를 활용할 경우, 크로미움 계열의 웹 브라우저만 있으면 됩니다. 다만, 로컬 PC에서 직접 개발할 경우, 아래와 같은 내용을 직접 준비해야 합니다.
 
 ### 공통
 
 - [Visual Studio Code](https://code.visualstudio.com/) 설치
+- VS Code [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) 익스텐션 설치
+- VS Code [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) 익스텐션 설치
 - [PowerShell 7](https://learn.microsoft.com/powershell/scripting/install/installing-powershell) 설치 👉 Windows 사용자용
 - [git CLI](https://git-scm.com/downloads) 설치
 - [GitHub CLI](https://cli.github.com/) 설치
@@ -24,22 +26,26 @@ GitHub Codespaces를 활용할 경우, 크로미움 계열의 웹 브라우저
 ### Python
 
 - [pyenv](https://github.com/pyenv/pyenv) 또는 [pyenv for Windows](https://github.com/pyenv-win/pyenv-win) 설치
-- VS Code [Python](https://marketplace.visualstudio.com/items/?itemName=ms-python.python) 익스텐션 설치치
+- pyenv를 통한 Python 3.12+ 이상 설치
+- VS Code [Python](https://marketplace.visualstudio.com/items/?itemName=ms-python.python) 익스텐션 설치
 - VS Code [Pylance](https://marketplace.visualstudio.com/items/?itemName=ms-python.vscode-pylance) 익스텐션 설치
 - VS Code [Python Debugger](https://marketplace.visualstudio.com/items/?itemName=ms-python.debugpy) 익스텐션 설치
 - VS Code [autopep8](https://marketplace.visualstudio.com/items/?itemName=ms-python.autopep8) 익스텐션 설치
 
 ### JavaScript
 
-- [Node.js](https://nodejs.org/) 설치 (LTS 버전 권장)
+- [nvm](https://github.com/nvm-sh/nvm) 또는 [nvm for Windows](https://github.com/coreybutler/nvm-windows) 설치
+- nvm을 통한 [Node.js](https://nodejs.org/) 설치 (LTS 버전 권장)
 - [Yarn](https://yarnpkg.com/getting-started/install) 패키지 매니저 설치
-  ```bash
-  npm install -g yarn
-  ```
+
+    ```bash
+    npm install -g yarn
+    ```
 
 ### Java
 
-- [OpenJDK 21](https://learn.microsoft.com/java/openjdk/download) 설치
+- [SDKMAN](https://sdkman.io/) 설치
+- SDKMAN을 통한 [OpenJDK 21](https://learn.microsoft.com/java/openjdk/download) 설치
 - VS Code [Extension Pack for Java](https://marketplace.visualstudio.com/items/?itemName=vscjava.vscode-java-pack) 익스텐션 설치
 - VS Code [Spring Boot Extension Pack](https://marketplace.visualstudio.com/items/?itemName=vmware.vscode-boot-dev-pack) 익스텐션 설치
 
@@ -48,12 +54,12 @@ GitHub Codespaces를 활용할 경우, 크로미움 계열의 웹 브라우저
 - [.NET SDK 9](https://dotnet.microsoft.com/download/dotnet/9.0) 설치
 - [VS Code C# Dev Kit](https://marketplace.visualstudio.com/items/?itemName=ms-dotnettools.csdevkit) 익스텐션 설치
 
-## 시작하기
-
 ## 시나리오
 
 Contoso 아웃도어 컴파니는 회사의 다양한 아웃도어용 제품 홍보를 위한 마이크로 소셜미디어 사이트를 개발하려고 합니다. 현재 개발 부서에는 Python 개발자가 백엔드 API를, JavaScript 개발자가 프론트엔드 웹 UI를 담당하고 있습니다. 마케팅 팀에서는 기본적인 MVP를 제작해서 웹사이트를 론칭할 계획을 세웠습니다. 하지만, 개발 기간이 촉박해서 빠르게 제작을 해야 하는 상황입니다.
 
+앗, 그런데 말입니다...
+
 ## 작업 문서
 
 아래 문서를 통해 자기주도학습의 형태로 직접 애플리케이션을 개발해 보세요!
@@ -66,7 +72,7 @@ Contoso 아웃도어 컴파니는 회사의 다양한 아웃도어용 제품 홍
 | 03: Java 앱 개발       | [03-java.md](./docs/03-java.md)             |
 | 04: .NET 앱 개발       | [04-dotnet.md](./docs/04-dotnet.md)         |
 
-### 완성본 예제 보기
+## 완성본 예제 보기
 
 모든 샘플 코드의 완성본 예제는 각 언어별 디렉토리에 있습니다. 하지만, 이는 GitHub Copilot으로 개발한 애플리케이션의 예시일 뿐 항상 이와 똑같이 만들어지는 것은 아닙니다.
 
@@ -77,31 +83,40 @@ Contoso 아웃도어 컴파니는 회사의 다양한 아웃도어용 제품 홍
 | Java       | [java](./java/)             |
 | .NET       | [dotnet](./dotnet/)         |
 
-### openapi.yaml에 대한 설명
+## `openapi.yaml` 문서에 대하여...
 
-openapi.yaml 파일은 우리가 만들 웹 API의 설계도라고 생각하면 됩니다. 마치 건물을 짓기 전에 건축 도면이 필요한 것처럼, API를 개발하기 전에 이 파일로 전체 구조를 미리 계획합니다.
+`openapi.yaml` 파일은 우리가 만들 웹 API의 설계도라고 생각하면 좋습니다. 마치 건물을 짓기 전에 건축 도면이 필요한 것처럼, API를 개발하기 전에 이 파일로 전체 구조를 미리 계획합니다.
 
 이 파일에서는 다음과 같은 내용을 정의합니다:
-- 어떤 기능들(포스트 작성, 댓글 달기, 좋아요 등)을 만들지
-- 각 기능을 사용하려면 어떤 주소(URL)로 요청해야 하는지
-- 요청할 때 어떤 정보가 필요한지(예: 포스트 내용, 사용자 이름)
+
+- 어떤 기능들(포스트 작성, 댓글 달기, 좋아요 등)을 만들지,
+- 각 기능을 사용하려면 어떤 주소(URL)로 요청해야 하는지,
+- 요청할 때 어떤 정보가 필요한지(예: 포스트 내용, 사용자 이름),
 - 요청 후 어떤 응답이 돌아오는지
 
 초보자에게 가장 큰 장점은:
-- 개발 전에 API 구조를 명확히 볼 수 있어 전체 그림을 이해하기 쉽습니다
-- 여러 개발자가 같은 규칙으로 작업할 수 있습니다
-- 자동으로 API 문서와 테스트 페이지가 생성됩니다
-- 클라이언트(앱이나 웹) 개발자와 서버 개발자 간의 소통이 쉬워집니다
+
+- 개발 전에 API 구조를 명확히 볼 수 있어 전체 그림을 이해하기 쉽습니다.
+- 여러 개발자가 같은 규칙으로 작업할 수 있습니다.
+- 자동으로 API 문서와 테스트 페이지가 생성됩니다.
+- 클라이언트(앱이나 웹) 개발자와 서버 개발자 간의 소통이 쉬워집니다.
 
 마치 레고 조립 설명서처럼, 어떤 부품이 어디에 들어가는지 미리 알려주는 역할을 합니다.
 
-openapi.yaml은 SNS 앱을 위한 API 설계도로, 다음 기능들을 정의합니다:
+`openapi.yaml`은 SNS 앱을 위한 API 설계도로, 다음 기능들을 정의합니다:
+
+- 포스트 관련 API (5개)
+  - 포스트 목록 조회, 작성, 상세 조회, 수정, 삭제
+- 댓글 관련 API (5개)
+  - 댓글 목록 조회, 작성, 상세 조회, 수정, 삭제
+- 좋아요 관련 API (2개)
+  - 좋아요 추가, 취소
+
+각 API는 필요한 요청 정보와 응답 형식, 오류 처리 방법을 명확히 정의하고 있어 개발 시 일관성 있는 인터페이스를 구현할 수 있습니다.
 
-* 포스트 관련 API (5개)
-** 포스트 목록 조회, 작성, 상세 조회, 수정, 삭제
-* 댓글 관련 API (5개)
-** 댓글 목록 조회, 작성, 상세 조회, 수정, 삭제
-* 좋아요 관련 API (2개)
-** 좋아요 추가, 취소
+## 참고 자료
 
-각 API는 필요한 요청 정보와 응답 형식, 오류 처리 방법이 명확히 정의되어 있어 개발 시 일관된 인터페이스를 구현할 수 있습니다.
+- [GitHub Copilot 에이전트 모드 및 MCP](https://code.visualstudio.com/blogs/2025/04/07/agentMode)
+- [GitHub Copilot 사용자 정의 지침(Custom Instruction)](https://code.visualstudio.com/docs/copilot/copilot-customization)
+- [GitHub Copilot AI 모델 바꾸기](https://docs.github.com/ko/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat?tool=vscode)
+- [GitHub Codespaces](https://docs.github.com/ko/codespaces/about-codespaces/what-are-codespaces)

docs/00-setup.md

@@ -2,21 +2,21 @@
 
 이 단계에서는 워크샵 진행을 위해 필요한 개발 환경을 설정합니다.
 
-## 순서
-
-- [사전 준비사항](#사전-준비사항)
-- [GitHub Codespaces로 시작하기](#github-codespaces로-시작하기)
-- [PowerShell 설치 확인 👉 Windows 사용자용](#powershell-설치-확인--windows-사용자용)
-- [git CLI 설치 확인](#git-cli-설치-확인)
-- [GitHub CLI 설치 확인](#github-cli-설치-확인)
-- [Docker Desktop 설치 확인](#docker-desktop-설치-확인)
-- [Visual Studio Code 설치 확인](#visual-studio-code-설치-확인)
-- [Visual Studio Code 시작](#visual-studio-code-시작)
-
 ## 사전 준비사항
 
 [README](../README.md) 문서를 참조하여 개발 환경을 준비합니다.
 
+## 순서
+
+- [GitHub Codespaces로 시작하기](#github-codespaces로-시작하기)
+- [Visual Studio Code로 시작하기](#visual-studio-code로-시작하기)
+  - [PowerShell 설치 확인 👉 Windows 사용자용](#powershell-설치-확인--windows-사용자용)
+  - [git CLI 설치 확인](#git-cli-설치-확인)
+  - [GitHub CLI 설치 확인](#github-cli-설치-확인)
+  - [Docker Desktop 설치 확인](#docker-desktop-설치-확인)
+  - [Visual Studio Code 설치 확인](#visual-studio-code-설치-확인)
+  - [Visual Studio Code 시작](#visual-studio-code-시작)
+
 ## GitHub Codespaces로 시작하기
 
 1. 아래 이미지를 따라 차례로 `[<> Code]` 👉 `[Codespaces]` 👉 `[Create codespace on main]`를 클릭해서 GitHub Codespaces 인스턴스를 생성합니다. 네트워크 사정에 따라 대략 5분-10분 정도 걸립니다.
@@ -34,6 +34,7 @@
     # Node.js 버전 확인
     node --version
     npm --version
+    yarn --version
     ```
 
     ```bash
@@ -55,15 +56,17 @@
    아래와 같은 결과가 보여야 합니다.
 
     ```bash
-    origin  https://github.com/devrel-kr/semantic-kernel-workshop.git (fetch)
-    origin  https://github.com/devrel-kr/semantic-kernel-workshop.git (push)
+    origin  https://github.com/devrel-kr/github-copilot-bootcamp-2025.git (fetch)
+    origin  https://github.com/devrel-kr/github-copilot-bootcamp-2025.git (push)
     ```
 
    만약 위와 같은 결과가 보이지 않는다면 GitHub Codespaces 인스턴스를 삭제하고 다시 생성해야 합니다.
 
 **👇👇👇 아래 내용부터는 로컬 PC에 VS Code를 설치하고 워크샵을 진행할 때 필요한 내용입니다. GitHub Codespaces 인스턴스를 사용한다면 이 문서의 마지막으로 건너뛰어도 좋습니다. 👇👇👇**
 
-## PowerShell 설치 확인 👉 Windows 사용자용
+## Visual Studio Code로 시작하기
+
+### PowerShell 설치 확인 👉 Windows 사용자용
 
 1. 터미널에서 아래 명령어를 실행시켜 현재 PowerShell을 설치했는지 확인합니다.
 
@@ -87,7 +90,7 @@
 
    `7.5.0` 이상의 버전이 있어야 합니다. 만약 이보다 버전이 낮다면 [PowerShell 설치 페이지](https://learn.microsoft.com/powershell/scripting/install/installing-powershell)에서 최신 버전을 다운로드 받아 설치합니다.
 
-## git CLI 설치 확인
+### git CLI 설치 확인
 
 1. 터미널에서 아래 명령어를 실행시켜 현재 git CLI를 설치했는지 확인합니다.
 
@@ -111,7 +114,7 @@
 
    `2.39.0` 이상의 버전이 있어야 합니다. 만약 이보다 버전이 낮다면 [git CLI 설치 페이지](https://git-scm.com/downloads)에서 최신 버전을 다운로드 받아 설치합니다.
 
-## GitHub CLI 설치 확인
+### GitHub CLI 설치 확인
 
 1. 터미널에서 아래 명령어를 실행시켜 현재 GitHub CLI를 설치했는지 확인합니다.
 
@@ -143,7 +146,7 @@
 
    만약 로그인하지 않았다고 나온다면, `gh auth login` 명령어를 통해 로그인합니다.
 
-## Docker Desktop 설치 확인
+### Docker Desktop 설치 확인
 
 1. 터미널에서 아래 명령어를 실행시켜 현재 Docker Desktop을 설치했는지 확인합니다.
 
@@ -167,7 +170,7 @@
 
    `28.0.4` 이상의 버전이 있어야 합니다. 만약 이보다 버전이 낮다면 [Docker Desktop 설치 페이지](https://docs.docker.com/get-started/introduction/get-docker-desktop/)에서 최신 버전을 다운로드 받아 설치합니다.
 
-## Visual Studio Code 설치 확인
+### Visual Studio Code 설치 확인
 
 1. 터미널에서 아래 명령어를 실행시켜 현재 Visual Studio Code를 설치했는지 확인합니다.
 
@@ -193,7 +196,7 @@
 
    > 만약 터미널에서 `code` 명령어를 실행시킬 수 없다면, [이 문서](https://code.visualstudio.com/docs/setup/mac#_launching-from-the-command-line)를 참고하여 설정합니다.
 
-## Visual Studio Code 시작
+### Visual Studio Code 시작
 
 1. 작업할 디렉토리로 이동합니다.
 1. 터미널에서 아래 명령어를 실행시켜 이 리포지토리를 자신의 GitHub 계정으로 포크한 후 자신의 컴퓨터로 클론합니다.
@@ -223,10 +226,28 @@
    이 명령어를 실행하면 아래와 같은 결과가 나와야 합니다. 만약 `origin`에 `devrel-kr`이 보이면 자신의 리포지토리에서 다시 클론해야 합니다.
 
     ```bash
-    origin  https://github.com/<자신의 GitHub ID>/semantic-kernel-workshop.git (fetch)
-    origin  https://github.com/<자신의 GitHub ID>/semantic-kernel-workshop.git (push)
-    upstream        https://github.com/devrel-kr/semantic-kernel-workshop.git (fetch)
-    upstream        https://github.com/devrel-kr/semantic-kernel-workshop.git (push)
+    origin  https://github.com/<자신의 GitHub ID>/github-copilot-bootcamp-2025.git (fetch)
+    origin  https://github.com/<자신의 GitHub ID>/github-copilot-bootcamp-2025.git (push)
+    upstream        https://github.com/devrel-kr/github-copilot-bootcamp-2025.git (fetch)
+    upstream        https://github.com/devrel-kr/github-copilot-bootcamp-2025.git (push)
+    ```
+
+1. 아래 명령어를 실행시켜 [GitHub Copilot 익스텐션](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)과 [GitHub Copilot Chat 익스텐션](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)을 설치했는지 확인합니다.
+
+    ```bash
+    # Bash/Zsh
+    code --list-extensions | grep github.copilot
+    ```
+
+    ```powershell
+    # PowerShell
+    code --list-extensions | Select-String "github.copilot"
+    ```
+
+   만약 아무 메시지도 보이지 않는다면, 아직 설치하지 않은 것입니다. 아래 명령어를 실행시켜 GitHub Copilot 익스텐션을 설치합니다.
+
+    ```bash
+    code --install-extension "github.copilot" --force && code --install-extension "github.copilot-chat" --force
     ```
 
 ---

docs/01-python.md

@@ -8,44 +8,55 @@ Contoso 아웃도어 컴파니의 마케팅 팀에서는 제품 홍보를 위한
 
 [README](../README.md) 문서를 참조하여 개발 환경을 준비합니다.
 
+## 순서
+
+- [개발 과정 프롬프트](#개발-과정-프롬프트)
+  - [FastAPI 앱 프로젝트 준비](#fastapi-앱-프로젝트-준비)
+  - [CRUD API 구현](#crud-api-구현)
+  - [가상환경으로 앱 실행](#가상환경으로-앱-실행)
+  - [API 확인](#api-확인)
+  - [기본 데이터베이스 테이블 생성](#기본-데이터베이스-테이블-생성)
+- [서비스 종료](#서비스-종료)
+
 ## 개발 과정 프롬프트
 
 아래는 FastAPI 앱을 개발하여 간단한 SNS 기능을 구현하는 과정입니다.
 
-* FastAPI 앱 프로젝트 준비
-* CRUD API 구현
-* 가상환경으로 앱 실행
-* API 확인
-* 기본 데이터베이스 테이블 생성
+- FastAPI 앱 프로젝트 준비
+- CRUD API 구현
+- 가상환경으로 앱 실행
+- API 확인
+- 기본 데이터베이스 테이블 생성
 
 ### FastAPI 앱 프로젝트 준비
 
 1. 가상환경 생성
 
-Python 프로젝트 디렉토리를 생성하고, 다음 명령어로 가상환경(venv)을 만듭니다:
+   Python 프로젝트 디렉토리를 생성하고, 다음 명령어로 가상환경(venv)을 만듭니다:
 
-```bash
-python -m venv .venv
-```
+    ```bash
+    python -m venv .venv
+    ```
 
-2. 가상환경 활성화 및 FastAPI 설치
+1. 가상환경 활성화 및 FastAPI 설치
 
-### Windows
+   **Windows**
 
-```bash
-.venv\Scripts\activate
-```
+    ```pwsh
+    .venv/Scripts/activate
+    ```
 
-### macOS / Linux
-```bash
-source .venv/bin/activate
-```
+   **MacOS**, **Linux** 또는 **GitHub Codespaces**
 
-```bash
-pip install fastapi uvicorn
-```
+    ```bash
+    source .venv/bin/activate
+    ```
 
-3. main.py 빈 파일 생성
+    ```bash
+    pip install fastapi uvicorn
+    ```
+
+1. main.py 빈 파일 생성
 
 ### CRUD API 구현
 
@@ -108,5 +119,3 @@ kill 12710
 ```
 
 그럼 다른 백엔드 서비스를 동일한 포트에서 실행할 수 있습니다.
-
-

docs/02-javascript.md

@@ -8,6 +8,12 @@ Contoso 아웃도어 컴파니의 마케팅 팀에서는 제품 홍보를 위한
 
 [README](../README.md) 문서를 참조하여 개발 환경을 준비합니다.
 
+## 순서
+
+- [개발 과정 프롬프트](#개발-과정-프롬프트)
+  - [React 앱 프로젝트 준비](#react-앱-프로젝트-준비)
+  - [React 앱 프로젝트 구축](#react-앱-프로젝트-구축)
+
 ## 개발 과정 프롬프트
 
 ### React 앱 프로젝트 준비