[CORE-011][실무] 공식 문서로 답을 찾는 연습 > IT 기술 공유

• 목록

[이번 수업]
모르는 기능을 만났을 때 검색 결과를 그대로 복사하지 않고, 공식 문서에서 현재 환경에 맞는 답을 찾고 작은 실험으로 확인하는 방법을 배웁니다. 문서를 전부 외우는 것이 목표가 아니라 질문을 좁히고 근거와 결과를 남기는 습관을 만드는 수업입니다.

[선수지식]
CORE-010의 오류 메시지와 로그 읽기, TOOL-002의 터미널 기초, PY-001의 Python 실행 방법을 알고 있으면 좋습니다.

[학습목표]
1. 학습 안내서, 사용 절차, 참조 문서, 개념 설명의 용도를 구분합니다.
2. 제품·언어 이름, 버전, 정확한 오류 문구로 검색 범위를 좁힙니다.
3. 공식 근거와 최소 재현 결과를 함께 기록해 다시 확인할 수 있습니다.

[핵심개념]
먼저 질문을 “왜 안 되지?”에서 “Python 3에서 문자열을 쉼표 기준으로 한 번만 나누려면?”처럼 바꿉니다. 환경도 운영체제, 언어·도구 버전, 입력, 기대 결과, 실제 결과로 나눠 적습니다. 검색할 때는 핵심 함수명이나 오류의 짧은 부분을 큰따옴표로 묶고 site:docs.python.org처럼 공식 문서 도메인을 제한할 수 있습니다.

문서에는 역할이 있습니다. 튜토리얼은 처음부터 따라가는 학습 안내서이고, 사용 절차는 특정 작업의 순서를 알려줍니다. 참조 문서는 함수의 인자·반환값·예외처럼 정확한 규칙을 찾을 때 쓰며, 개념 설명은 설계 이유와 배경을 이해할 때 씁니다. 표준 문서의 MUST는 반드시 지켜야 한다는 뜻이고 SHOULD는 특별한 이유가 없다면 지켜야 한다는 뜻입니다. 번역본이나 블로그로 개념을 잡았더라도 최종 판단은 사용 중인 버전의 공식 문서, 릴리스 노트, 보안 권고에서 확인합니다.

좋은 확인 기록에는 질문, 환경과 버전, 공식 URL, 최소 입력, 예상 결과, 실제 결과, 결론이 들어갑니다. 문서의 예제를 더 작은 입력으로 실행해 보고 경계값 하나를 바꾸면 이해가 단단해집니다. 문서와 결과가 다르면 버전 차이, 운영체제 차이, 오타, 숨은 설정을 차례로 확인하세요.

[따라하기]
Python 내장 자료형 문서에서 str.split을 찾은 뒤 아래 코드를 docs_check.py로 저장하세요.

import sys

sample = "red,green,blue"
print("Python:", sys.version.split()[0])
print("입력:", repr(sample))
print("기본 분리:", sample.split(","))
print("한 번만 분리:", sample.split(",", maxsplit=1))

macOS와 Linux에서는 python3 docs_check.py, Windows PowerShell에서는 py docs_check.py를 실행합니다. 첫 줄의 버전 번호는 환경마다 다릅니다. 나머지 예상 결과는 입력: 'red,green,blue', 기본 분리: ['red', 'green', 'blue'], 한 번만 분리: ['red', 'green,blue']입니다. 공식 문서에서 sep와 maxsplit의 뜻을 찾아 결과가 규칙과 맞는지 설명하세요.

[흔한 실수]
검색 결과의 날짜와 대상 버전을 보지 않거나, 비슷한 이름의 비공식 사이트를 공식 문서로 착각하기 쉽습니다. 첫 번째 답만 믿고 긴 명령을 바로 실행하는 것도 위험합니다. 오류 문구 전체에 사용자 이름·경로·토큰을 섞어 검색하지 말고, 재현에 필요한 부분만 남기세요. 예제 한 번의 성공을 모든 입력에서 성립하는 규칙으로 일반화하지 마세요.

[보안 주의]
실습은 본인 소유의 로컬 환경과 공개 가능한 예제 데이터로만 진행합니다. 검색창, 공개 게시판, AI 도구에 비밀번호, API 키, 쿠키, 내부 주소, 개인정보, 비공개 코드를 붙여 넣지 마세요. 인터넷에서 찾은 설치 명령이나 스크립트는 공식 출처와 대상 버전을 확인하고 내용을 읽은 뒤 격리 환경에서 시험합니다. 관리자 권한을 요구하면 필요성을 먼저 확인하세요.

[직접 해볼 과제]
공식 Python 문서에서 str.removeprefix를 찾아 기능, 사용 가능한 버전, 최소 예제, 예상 결과를 한 장의 확인 기록으로 작성하세요. 그다음 입력이 접두사와 일치하지 않을 때의 결과를 직접 실행해 문서 설명과 비교하세요.

[확인문제]
1. 튜토리얼과 참조 문서는 각각 언제 선택해야 하나요?
2. 검색 전에 환경과 버전을 적어야 하는 이유는 무엇인가요?
3. 문서 설명과 실행 결과가 다를 때 확인할 항목 두 가지는 무엇인가요?

[다음 학습]
다음 차례인 CS-011에서 반복되는 문제 해결 구조를 설계 패턴으로 정리합니다. CORE 트랙에서는 CORE-012에서 내 컴퓨터 구조와 네트워크를 설명하는 미니 프로젝트로 이어집니다.

[공식 참고 자료]
Python 튜토리얼
https://docs.python.org/3/tutorial/
Python 내장 자료형 str.split 참조
https://docs.python.org/3/library/stdtypes.html#str.split
MDN 웹 개발 학습 자료
https://developer.mozilla.org/en-US/docs/Learn_web_development
RFC 2119 요구 수준 키워드
https://www.rfc-editor.org/rfc/rfc2119
검색 결과 좁히기 도움말
https://support.google.com/websearch/answer/2466433