본문 바로가기

쪼개고 합치기

1. 쪼개고 합치기

위키는 자라면서 모양이 어긋납니다. 어떤 문서는 너무 커지고 어떤 문서는 두 장으로 갈라져 있습니다. 이 절에서 그 정리를 다룹니다.

1.1 언제 쪼개나

길이가 유일한 기준은 아닙니다. 신호가 셋 있습니다.

소제목 아래 내용이 독립적으로 자랐을 때. competitor-a.md의 '기업 교육 사업' 절이 혼자 화면 한 쪽을 넘겼다면, 그건 이미 별도 문서입니다.

다른 문서에서 그 일부만 참조할 때. 다른 문서들이 [[competitor-a]]를 링크하면서 "기업 교육 부분 참고"라고 적고 있다면, 그 부분이 독립된 문서여야 링크가 정확해집니다.

갱신 주기가 다를 때. 회사 개요는 1년에 한 번 바뀌고 요금제는 분기마다 바뀝니다. 한 문서에 있으면 자주 바뀌는 쪽 때문에 문서 전체가 계속 손질됩니다.

세 신호 중 둘 이상이면 쪼갭니다. 화면 세 쪽이 넘어도 신호가 하나도 없으면 그냥 둡니다.

1.2 쪼개기

쪼갤 때 가장 흔한 사고는 링크가 끊기는 것입니다. 원래 문서를 가리키던 링크들이 새 문서의 내용을 가리켜야 하는데, 이름이 바뀌면서 엉뚱한 데를 가리킵니다.

순서를 지정해 줍니다.

competitor-a.md 를 두 문서로 나눠줘.

- competitor-a.md : 회사 개요, 우리와의 관계, 시간순 기록
- competitor-a-pricing.md : 요금 구조와 무료 체험 관련 내용 전부

나눈 뒤에 이걸 해줘.
1. 두 문서가 서로를 관련 문서에 링크하게.
2. wiki/ 전체에서 competitor-a를 링크하던 문서들을 확인하고,
   요금 이야기를 하던 자리는 competitor-a-pricing으로 바꿔줘.
   어느 문서의 어느 줄을 바꿨는지 목록으로 알려줘.
3. index.md에 새 문서를 추가해줘.

바꾸기 전에 2번에서 몇 개 문서가 영향받는지 먼저 알려줘.

작업이 끝나면 Obsidian에서 확인합니다. 새 문서를 열고 백링크 패널을 봅니다. 요금 관련 문서들이 여기 나와야 정상입니다.

1.3 언제 합치나

쪼개는 것보다 합치는 것이 더 자주 필요합니다. 인제스트를 반복하다 보면 비슷한 문서가 여럿 생기기 때문입니다.

같은 대상에 문서가 둘일 때. 파일 이름 규칙이 안 지켜져서 competitor-a.md와 a사.md가 따로 생긴 경우입니다. 무조건 합칩니다.

둘 다 짧고 항상 같이 읽힐 때. free-trial.md와 trial-length.md가 각각 다섯 줄이고 내용이 이어진다면 나눌 이유가 없습니다.

한쪽이 다른 쪽의 부분집합일 때. 나중에 만든 문서가 앞 문서의 내용을 대부분 포함하는 경우입니다.

합치기 전에 무엇이 사라지는지 확인합니다.

free-trial.md 와 trial-length.md 를 합치려고 해.

합치기 전에 먼저 보여줘.
- 두 문서에서 겹치는 내용
- 한쪽에만 있는 내용
- 서로 어긋나는 내용이 있는지

어긋나는 게 있으면 합치지 말고 먼저 알려줘.

마지막 줄이 안전장치입니다. 두 문서가 서로 다른 말을 하고 있다면 합치는 과정에서 한쪽이 조용히 사라집니다. 그건 합치기가 아니라 삭제입니다.

1.4 합치기

확인이 끝났으면 합칩니다.

free-trial.md 로 합쳐줘. trial-length.md 의 내용을 흡수하고,
겹치는 문장은 하나로 정리하되 출처는 둘 다 남겨줘.

합친 뒤에
1. trial-length.md 를 지우기 전에 그 문서를 링크하던 곳을 전부 찾아
   free-trial 로 바꿔줘.
2. index.md 에서 trial-length 항목을 지워줘.
3. log.md 에 합친 기록을 남겨줘.

세 번째가 중요합니다. 문서를 지운 것도 기록입니다. 나중에 "그때 그 문서 어디 갔지"라는 의문이 생겼을 때 기록에서 찾을 수 있습니다.

1.5 폴더를 옮길 때

문서를 다른 폴더로 옮기는 경우도 있습니다. topics/에 있던 것이 알고 보니 개념 문서였던 경우입니다.

4장에서 Obsidian의 링크 형식을 짧은 이름으로 설정해 뒀다면, 폴더가 바뀌어도 [[free-trial]]이라는 링크는 그대로 유효합니다. 파일 이름만 안 바뀌면 됩니다.

이게 짧은 링크를 쓰는 이유입니다. 전체 경로로 링크했다면 [[wiki/topics/free-trial]]이 전부 깨졌을 것입니다.

다만 색인은 고쳐야 합니다.

topics/free-trial.md 를 concepts/ 로 옮겨줘.
파일 이름은 그대로 두고.
옮긴 뒤 index.md에서 그 항목을 개념 절로 옮겨줘.

1.6 정기적으로 구조 점검하기

자료를 스무 건쯤 넣을 때마다 구조를 한 번 봅니다.

wiki/ 전체 구조를 점검해줘.

1. 화면 세 쪽이 넘는 문서와, 각각 쪼갤 만한 지점
2. 다섯 줄 이하로 짧은 문서와, 합칠 만한 상대
3. 같은 대상을 다루는데 따로 있는 문서
4. 폴더 종류가 안 맞아 보이는 문서
   (entities에 있는데 실은 개념이거나 그 반대)

각 항목마다 제안만 하고 아직 고치지는 마.

이 점검을 받아 보면 대개 서너 건이 나옵니다. 그중 지금 고칠 것과 나중에 볼 것을 사람이 고릅니다. 전부 고치려고 하면 위키 정리에 하루를 쓰게 되는데, 위키는 정리하려고 만든 것이 아니라 쓰려고 만든 것입니다.

다음 장에서 이렇게 정돈된 위키에 질문을 던집니다.

쪼개고 합치기 - LLM 위키 에센셜 | 위니버시티