문화권에 따라 달라지는 문서 표현

같은 내용을 전달하더라도, 문화권에 따라 적절한 표현은 달라집니다. 직접적인 표현이 자연스러운 곳이 있고, 완곡한 표현이 예의인 곳이 있습니다. 문서가 여러 문화권의 독자를 만난다면, 문화권에 따라 달라지는 표현의 차이를 이해해야 합니다.

싱글 소싱 흐름을 보여주는 도판
한 번 작성하고 여러 매체로 변환하다. 문화권에 맞춘 표현도 그 흐름의 일부입니다.

더 읽기

커뮤니티 기여가 시스템을 개선하는 방식

오픈소스 시스템이 한 회사의 제품보다 빠르게 나아지는 데는 이유가 있습니다. 그 시스템을 쓰는 수많은 사람이 직접 개선에 참여하기 때문입니다. 커뮤니티 기여가 시스템을 개선하는 방식을 들여다보면, 열린 시스템이 가진 힘의 정체가 보입니다.

기여와 개선이 순환하는 구조를 보여주는 도판
피드백이 도는 순환 구조. 기여가 개선을 부르고 개선이 다시 기여를 부릅니다.

더 읽기

기여자가 제안을 보내기 쉬운 환경 만들기

오픈소스 프로젝트의 활력은 기여자의 수에 달려 있습니다. 그런데 좋은 시스템을 만들어 두어도 기여하기가 어려우면 사람들은 손을 보태지 않습니다. 기여자가 제안을 보내기 쉬운 환경을 만드는 일은, 시스템 자체를 잘 만드는 것만큼이나 중요합니다.

기여자들이 연결된 네트워크를 보여주는 도판
기여자들이 연결된 네트워크. 문턱이 낮을수록 이 그물이 촘촘해집니다.

더 읽기

문서 버전 관리의 기본기

문서는 시간이 지나며 계속 바뀝니다. 그런데 어떻게 바뀌어 왔는지 추적할 수 없으면, 실수를 되돌리거나 이전 상태를 확인하기 어렵습니다. 문서 버전 관리의 기본기를 갖추면, 변화하는 문서를 안정적으로 다룰 수 있습니다.

작업 흐름의 단계를 보여주는 도판
작성에서 발행까지의 흐름. 버전 관리는 이 흐름의 모든 변화를 기록합니다.

더 읽기

마크업 규칙을 팀 전체가 지키게 만드는 방법

아무리 좋은 마크업 규칙을 정해도, 팀원들이 지키지 않으면 소용이 없습니다. 문서의 일관성은 규칙의 정교함이 아니라 그 규칙이 실제로 지켜지느냐에 달려 있습니다. 마크업 규칙을 팀 전체가 자연스럽게 지키게 만드는 데는 몇 가지 요령이 있습니다.

문서 트리 구조를 보여주는 도판
하나의 소스에서 뻗어 나가는 문서 구조. 규칙이 지켜져야 구조가 유지됩니다.

더 읽기

표준 준수 브라우저를 위한 문서 최적화

웹 문서는 결국 브라우저를 통해 사용자에게 닿습니다. 그런데 브라우저마다 문서를 해석하는 방식에 차이가 있어, 한 곳에서 잘 보이던 문서가 다른 곳에서는 깨지기도 합니다. 표준을 준수하는 브라우저를 위한 문서 최적화는 이 차이를 줄여 어디서나 일관된 결과를 얻는 방법입니다.

항목별 비교 매트릭스를 보여주는 도판
항목별로 비교한 매트릭스. 브라우저별 해석 차이를 정리하면 대응이 보입니다.

더 읽기

정보 과잉 시대에 문서가 갖춰야 할 조건

정보가 부족하던 시대에는 더 많이 쓰는 것이 미덕이었습니다. 그러나 지금은 정반대의 문제에 직면해 있습니다. 문서는 넘쳐 나는데 정작 필요한 답은 찾기 어렵습니다. 정보 과잉의 시대에 좋은 문서란, 더 많은 내용을 담은 문서가 아니라 필요한 것을 빠르게 건네주는 문서입니다.

수치로 본 문서 상태를 보여주는 도판
지표로 측정한 문서 품질. 양이 늘수록 무엇이 쓸모 있는지 가려내는 일이 중요해집니다.

더 읽기

지식 공유를 위한 국제 권고안 읽기

국제 표준화 기구가 펴내는 권고안은 지식이 어떻게 공유되고 합의되는지를 보여 주는 좋은 자료입니다. 처음에는 딱딱하고 어렵게 느껴지지만, 읽는 법을 알면 그 안에 담긴 깊은 고민과 합의의 과정을 발견할 수 있습니다. 국제 권고안을 읽는 일은 문서를 다루는 사람에게 특히 유익합니다.

항목별 비교 매트릭스를 보여주는 도판
항목별로 비교한 매트릭스. 권고안의 구조를 파악하면 읽기가 쉬워집니다.

더 읽기

복사 붙여넣기가 문서를 망치는 이유

복사 붙여넣기는 가장 빠르고 익숙한 작업 방식입니다. 비슷한 내용이 필요하면 기존 것을 복사해 조금 고쳐 쓰면 됩니다. 그러나 이 편리함 뒤에는 시간이 지날수록 문서를 망가뜨리는 함정이 숨어 있습니다.

하나의 소스가 여러 갈래로 갈라지는 도판
하나의 내용이 여러 사본으로 갈라지는 구조. 복사는 이렇게 사본을 늘립니다.

더 읽기

W3C 표준이 문서 호환성에 주는 의미

문서가 한 곳에서 만들어져 여러 환경에서 읽힐 때, 그 사이를 이어 주는 것이 표준입니다. W3C 표준은 웹 문서가 어디서나 같은 방식으로 해석되도록 약속을 정합니다. 이 표준이 문서 호환성에 주는 의미를 이해하면, 왜 표준을 따르는 것이 중요한지 분명해집니다.

계층으로 구조화된 문서를 보여주는 도판
계층으로 구조화된 문서. 표준은 각 계층이 호환되도록 규칙을 정합니다.

더 읽기