# Project Name

프로젝트 한 줄 설명

## Features

- 주요 기능 1
- 주요 기능 2

## Quick Start

### Prerequisites

- 필요한 런타임/도구 목록

### Installation

\`\`\`bash
[설치 명령어]
\`\`\`

### Usage

\`\`\`
[사용 예시]
\`\`\`

## Documentation

자세한 문서는 [여기](./docs)를 참조하세요.

## Contributing

기여 가이드는 [CONTRIBUTING.md](./CONTRIBUTING.md)를 참조하세요.

## License

MIT

## `functionName(param1, param2)`

함수 설명

### Parameters

| Name | Type | Required | Default | Description |
|------|------|----------|---------|-------------|
| param1 | `string` | Yes | - | 파라미터 설명 |
| param2 | `number` | No | `10` | 파라미터 설명 |

### Returns

`Result` - 반환값 설명

### Throws

- `ValidationError` - param1이 비어있을 때
- `NetworkError` - API 호출 실패 시

### Example

\`\`\`
result = functionName("value", 20)
print(result)
// Output: { success: true, data: ... }
\`\`\`

### Notes

- 특별한 주의사항
- 성능 관련 정보

# Changelog

All notable changes to this project will be documented in this file.

## [Unreleased]

### Added
- 새로운 기능

### Changed
- 변경된 기능

### Deprecated
- 곧 제거될 기능

### Removed
- 제거된 기능

### Fixed
- 버그 수정

### Security
- 보안 관련 수정

## [1.0.0] - YYYY-MM-DD

### Added
- Initial release
- Feature A
- Feature B

# Contributing Guide

프로젝트에 기여해주셔서 감사합니다!

## How to Contribute

1. 이슈 확인 또는 생성
2. Fork 후 브랜치 생성
3. 변경사항 구현
4. 테스트 작성 및 실행
5. PR 생성

## Development Setup

\`\`\`bash
git clone https://github.com/user/project
cd project
[설치 명령어]
[테스트 명령어]
\`\`\`

## Code Style

- 프로젝트 코드 스타일 가이드 준수
- 포맷터 사용

## Commit Messages

Conventional Commits 형식을 따릅니다.

## Pull Request Process

1. 테스트 통과 확인
2. 문서 업데이트 (필요시)
3. 리뷰어 지정
4. 승인 후 머지

# WHY를 설명하는 주석
# 비즈니스 규칙: 30일 후 자동 만료
EXPIRY_DAYS = 30

# 복잡한 비즈니스 로직 설명:
# - 트라이얼 기간은 구독으로 취급
# - 취소된 구독도 기간 종료 전까지 활성
function calculateSubscriptionStatus(user):
    ...

# Bad: 코드가 이미 설명하는 내용
# i를 1 증가
i = i + 1

# Bad: 오래된 주석
# TODO: 나중에 수정 (2019년...)

# Bad: 주석 처리된 코드
# function oldImplementation(): ...

# 주문 총액을 계산합니다.
#
# @param items - 주문 항목 배열
# @param discount - 할인율 (0-1 사이)
# @returns 할인이 적용된 총액
#
# @example
#   total = calculateOrderTotal(items, 0.1)
#
# @throws ValidationError items가 비어있을 때
# @since 1.2.0
function calculateOrderTotal(items, discount = 0):
    ...