# Sleek YTDner 기여 가이드

먼저, 기여해주셔서 감사합니다! ❤️

모든 종류의 기여를 환영하며 소중하게 생각합니다. 어떤 방식으로 도울 수 있는지, 그리고 이 프로젝트가 기여를 어떻게 관리하는지 확인하려면 [목차](#목차)를 참고하세요. 기여하기 전에 관련 내용을 꼭 읽어주시면 관리자와 기여자 모두에게 큰 도움이 됩니다.

## 목차 (Table of Contents)

- [질문이 있습니다](#질문이-있습니다)
- [기여하고 싶습니다](#기여하고-싶습니다)
  - [버그 제보](#버그-제보)
  - [개선 제안](#개선-제안)
  - [첫 코드 기여](#첫-코드-기여)

## 질문이 있습니다

> 질문하기 전에 제공된 [문서](README_ko.md)를 먼저 읽어보시길 권장합니다.

질문이 있다면 먼저 GitHub [Issues](https://github.com/hslcrb/pypack_sleek_a-ytdownloader-pkg/issues)에서 비슷한 내용이 있는지 검색해보세요. 적절한 이슈를 찾았는데도 명확하지 않다면, 해당 이슈에 질문을 남겨주시면 됩니다.

## 기여하고 싶습니다

### 버그 제보

- GitHub [Issues](https://github.com/hslcrb/pypack_sleek_a-ytdownloader-pkg/issues)에서 **이미 제보된 버그인지 검색**해주세요.
- 문제를 다루는 열린 이슈를 찾지 못했다면, 새로운 이슈를 열어주세요. **명확한 제목과 설명**, 그리고 가능한 많은 관련 정보를 포함해주시고, 예상되는 동작과 실제 동작을 보여주는 **코드 샘플**이나 **테스트 케이스**를 첨부해주시면 좋습니다.

### 개선 제안

- `enhancement` 라벨을 달고 새 이슈를 열어주세요.
- 기대하는 동작을 단계별로 설명해주세요.
- 이 개선 사항이 대다수의 사용자에게 왜 유용한지 설명해주세요.

### 첫 코드 기여

1. **저장소를 포크(Fork)**하고 로컬에 클론(Clone)합니다.
2. 새 브랜치를 생성합니다: `git checkout -b my-feature-branch`.
3. **개발 모드로 설치합니다**: `pip install -e .` (변경 사항을 즉시 테스트할 수 있습니다).
4. 변경 사항을 적용하고 커밋합니다: `git commit -m 'Add some feature'`.
5. 원본 브랜치로 푸시(Push)합니다: `git push origin my-feature-branch`.
6. 풀 리퀘스트(Pull Request)를 생성합니다.

## 스타일 가이드

### 커밋 메시지

- 현재 시제를 사용하세요 ("Added feature"가 아니라 "Add feature").
- 명령조를 사용하세요 ("Moves cursor to..."가 아니라 "Move cursor to...").
- 첫 줄은 72자 이내로 작성하세요.
- 첫 줄 뒤에 관련 이슈나 풀 리퀘스트를 자유롭게 참조하세요.
- **이중 언어(영어/한국어)** 커밋 메시지는 필수는 아니지만 환영합니다.

### 코딩 표준

- **Python**: PEP 8을 따릅니다.
- **HTML/CSS/JS**: 깔끔하고 의미론적(semantic)인 코드를 유지하며, 필요한 곳에 주석을 답니다.
- **디자인**: '글래스모피즘(Glassmorphism)' 비주얼 언어를 존중해주세요.

## 데이터 프라이버시 및 안전

Sleek YTDner는 프라이버시를 최우선으로 설계되었습니다. 사용자의 명시적인 동의 없이 추적, 분석 도구를 추가하거나 승인되지 않은 외부 서버와 통신하는 코드는 제출하지 마세요.

기여해주셔서 감사합니다!

---
[English](CONTRIBUTING.md) | [한국어](CONTRIBUTING_ko.md)
