| name | korean-beginner-pedagogy |
| description | 온톨로지·기술 개념을 한국어 비전공 초보자에게 쉽고 친근하게 전달하는 글쓰기 가이드. 정중체 톤, 전문 용어 풀이 3종 세트, 비유 활용, 인지 부하 분산, 단락 호흡, 모바일 가독성을 위한 챕터 본문 작성 시 사용. |
한국어 초보자 교육 글쓰기
온톨로지를 전혀 모르는 한국어 사용자가 즐겁고 자신감 있게 읽어 나갈 수 있는 본문을 쓴다.
톤 규칙
정중체, 그러나 딱딱하지 않게
"~합니다", "~예요/이에요" 사용. "~한다"(서술체) 또는 반말은 X.
나쁜 예: "클래스는 객체의 집합을 정의한다."
좋은 예: "클래스는 비슷한 사물을 묶어 부르는 이름이에요. 예를 들어 '포켓몬'은 피카츄, 라이츄 같은 개체들을 묶는 클래스죠."
"여러분"으로 호명
학습자를 "여러분"으로 부르며 함께 탐험하는 분위기. "독자는...", "사용자는..." 같은 3인칭 X.
호기심 자극 도입
각 챕터·각 섹션은 질문 또는 시나리오로 시작.
나쁜 예: "이번 챕터에서는 클래스에 대해 알아보겠습니다."
좋은 예: "여러분이 포켓몬 도감을 만든다고 해봅시다. 피카츄, 라이츄, 피츄… 이들을 하나하나 적다 보니 '얘네 다 비슷한데?'라는 생각이 들지 않나요? 이 생각이 바로 오늘 배울 핵심이에요."
전문 용어 풀이 3종 세트
새 용어 첫 등장 시 한국어 / 영어 / 짧은 풀이 세트로:
클래스(class, 종류·범주)
인스턴스(instance, 개체·실제 예)
속성(property, 특징·연결)
트리플(triple, 세 부분으로 된 사실 한 조각)
마크다운 또는 커스텀 태그로:
<concept ko="클래스" en="Class">사물을 비슷한 것끼리 묶은 범주</concept>
인지 부하 분산
한 단락에 한 가지 아이디어. 단락은 2~4문장.
나쁜 예 (한 덩어리):
온톨로지는 어떤 도메인의 개념·관계·제약을 형식적으로 표현한 명세이며, RDF와 OWL 같은 표준 언어로 작성되고 SPARQL로 질의할 수 있으며 추론 엔진을 통해 도출된 사실을 얻을 수 있습니다.
좋은 예 (분산):
온톨로지는 한 분야의 "지식 지도"예요.
그 분야에 어떤 개념들이 있고, 그 개념들이 서로 어떻게 연결되는지 그림처럼 표현합니다.
우리는 포켓몬이라는 친근한 세계로 그 지도를 그려볼 거예요.
비유 적극 활용
추상 개념마다 일상 비유 1개:
| 추상 개념 | 일상 비유 |
|---|
| 클래스 | "포켓몬"이라는 범주, 책의 장르 |
| 인스턴스 | 우리 집 강아지 한 마리, 이 책 한 권 |
| is-a | "전기 타입은 포켓몬의 한 종류" = "치즈피자는 피자의 한 종류" |
| 트리플 | "X는 Y와 Z의 관계가 있다" = 3단 문장 |
| 속성 | 사람의 키·몸무게·친구 관계 |
| 추론 | "A가 B의 형이고 B가 C의 형이면, A는 C의 큰형" 자동 알아내기 |
| SPARQL | "도서관 검색대에 가서 조건 적어내기" |
비유는 한국어 정서에 맞게. 영어 비유 직역 X.
모바일 가독성
- 단락 짧게 (2~4문장)
- 긴 문장은 마침표로 자르기
- 빈 줄 자주 (시각적 호흡)
- 코드 블록은 짧게. 길면 접기/펴기
- 표는 작게. 큰 표는 그래프로 대체
챕터 본문 구조
각 챕터 본문은 다음 흐름을 권장:
1. <도입 시나리오> (2~3 단락)
- 호기심 자극 질문 또는 포켓몬 상황
- "왜 이게 필요한가?"
2. <첫 만남>
- 새 개념을 가벼운 비유로 소개
- <concept> 태그로 정식 용어 도입
- <example pokemon="...">로 구체 포켓몬 예시
3. <조금 더 깊이>
- 정의를 좀 더 정확히
- 다른 도메인 한 줄 예시
- <aha>로 깨달음 모먼트 강조
4. <그래프로 확인>
- <graph-ref slice="ch{N}"/> 임베드
- "그림을 보면..." 가이드 문장
5. <실습 안내>
- 실습 자연스럽게 시작
- "이제 직접 해볼게요"
6. <정리>
- "이번 챕터에서 배운 것" 3~5 불릿
피해야 할 표현
| 피하기 | 대신 |
|---|
| "위에서 본 것처럼" | "방금 본 것처럼" (스크롤로 위/아래 모호함) |
| "다음 그림을 보자" | "다음 그림을 봐 주세요" |
| "쉽게 말해" | "비유하자면", "다시 말해" (쉬움을 강요 X) |
| "당연히", "단순히" | "...라고 볼 수 있어요" |
| "이는 ~이다" | "이건 ~예요" |
| "객체(Object)" 같이 영어 우선 | "객체(Object)" — 한국어 먼저 |
"잘 따라온다"는 신호 만들기
학습자가 자신감을 느끼도록 정기적으로:
- "여기까지 잘 따라오셨어요"
- "지금까지 본 게 사실 온톨로지의 핵심이에요"
- "이제 이 개념으로 더 큰 그림을 그려볼게요"
칭찬을 남발하지 말 것. 진짜 의미 있는 진척 지점에서만.
실수와 헷갈림 정상화
학습자가 헷갈리는 건 정상이라고 명시:
처음 보면 "클래스"랑 "인스턴스"가 헷갈릴 수 있어요.
사실 거의 모든 사람이 한 번씩 헷갈리고 지나갑니다.
다음 실습에서 직접 분류해보면서 자연스럽게 익혀볼게요.
챕터 정리 카드
마지막은 짧고 강하게:
## 이 챕터에서 배운 것
- **클래스**: 비슷한 사물을 묶는 범주 (예: "포켓몬", "전기 타입")
- **인스턴스**: 클래스에 속한 실제 개체 (예: "피카츄", "라이츄")
- 클래스와 인스턴스를 연결하는 관계: `is-a`
- 한 인스턴스는 여러 클래스에 속할 수 있다 (다음 챕터에서!)
검증 체크리스트 (집필 후)