나의 컨벤션 위키¶
C++ 코드와 Git 작업에서 반복되는 선택을 일관되게 하기 위한 개인 개발 기준입니다.
현재 C++ 코딩 11개, Git 2개, 좌표축·행렬 1개, 총 14개 문서에 채택 범위가 있습니다. 문서 안의 초안·미결정 정책은 제외하며 적용 범위와 변경 기록은 컨벤션 적용 기준에서 확인하세요.
빠르게 찾아보기¶
| 지금 하려는 작업 | 찾아볼 규칙 |
|---|---|
| 이름을 짓고 코드를 정리하기 | 포맷 · 명명 · 네임스페이스 |
| 변수와 객체 만들기 | auto 사용 · 초기화 · const |
| 사용자 정의 타입 설계하기 | 클래스·구조체 |
| 함수와 헤더 작성하기 | 함수 매개변수·반환 · 헤더·include |
| C++ 파일·프로젝트 구성 정리하기 | 프로젝트 구조와 파일 배치 |
| 코드의 의도 설명하기 | 주석 |
| 자원의 소유자와 수명 정하기 | 소유권·수명 |
| 좌표축 정하기·CPU와 셰이더의 행렬 해석 맞추기 | 좌표축과 행렬 규약 |
| 변경을 기록하고 작업 시작하기 | 커밋 메시지 · 브랜치 명명 |
처음 읽는 순서¶
- 컨벤션 적용 기준에서 적용 범위와 규칙 강도를 확인합니다.
- C++ 목차에서 포맷·명명·주석부터 값·타입, 파일·API·자원 관리 순으로 읽습니다. 초안은 채택 규칙과 구분해 검토합니다.
- 소유권·수명에서 자원 관리 규칙을, Git·협업에서 작업 기록 방식을 확인합니다.
각 페이지의 필수, 권장, 선택을 구분해 적용합니다. 프로젝트의 별도 합의는 적용 기준에 따라 범위와 이유를 명시한 예외로 관리합니다.
전체 목차¶
다음 분류에는 아직 채택하지 않은 초안과 후속 항목이 있습니다.
- Unity: 오브젝트·에셋 명명, 반복 번호와 기본 폴더 구조
- 테스트·품질: 테스트 범위, 회귀 검증과 품질 판단
- 문서화: README, 사용 안내와 설계 결정 기록
- 프로젝트별 규칙: 프로젝트별 설계, 구성·빌드와 공통 규칙의 예외
적용 절차와 검토 중인 문서¶
- C++ 자료형 선택과 별칭: 표준·API 타입, 자체 별칭·강한 타입, 외부 데이터 계약 (초안)
- C++ 타입 변환과 범위 검사: 목적별 캐스트, API 출력 인자, 숫자 변환·산술 범위 (초안)
- 클래스·구조체의 미결정 정책: 생성 실패·소멸 진단·noexcept, 다형적 복제·복잡한 상속 (초안, 기본 규칙은 채택)
- C++ attribute 사용: nodiscard의 언어 동작·다른 attribute의 목적과 사용 조건 (초안)
- Unity 오브젝트·에셋 이름과 폴더 구조: PascalCase·구분자, 반복 이름, 폴더와 참조 보존 (초안)
- RnimanEngine 프로젝트 기준: 컨벤션 적용·핵심 제약과 주요 원본 링크
- 위키의 적용과 프로젝트 근거 검토: 프로젝트의 위키 확인·적용과 위키 정비 시 프로젝트 조사 (채택)
- HLSL 셰이더 규칙: 단계별 파일과
Main, 명명·좌표 공간·공유 include (초안) - HTML 기본 컨벤션: 문서 골격·포맷·의미 있는 요소·입력·JSX 차이 (초안)
- Material Forge 참고 기록: HTML 초안의 로컬 근거와 프로젝트 적용 상태
- 변경 검증과 결과 기록: 빌드·실행·화면·성능 확인
- 원본과 생성물 관리: 에셋·산출물·캐시 구분
새 초안은 채택 범위가 있는 문서 14개에 포함하지 않으며 채택 문서 안의 초안·미결정 정책도 적용 범위에서 제외합니다. 프로젝트별 정보와 원본 접근 안내는 해당 프로젝트 문서에서 확인합니다.
참고 자료 안내¶
외부 가이드의 권고와 개인적으로 채택한 규칙은 각 페이지에서 구분합니다. 과거 개인 자료인 ref/는 로컬에만 보관하며 사이트에 포함하지 않습니다. 사이트에서 “로컬 참고 자료”로 표시된 출처는 공개 링크가 아닙니다.