기술적 글쓰기는 단순히 정보를 나열하는 데 그치지 않습니다. 독자가 그 정보를 이해하고, 필요에 따라 행동할 수 있도록 이끄는 것이 핵심입니다. 이를 위해 네 가지 기본 원칙—명확성, 간결성, 정확성, 객관성—을 지키는 것이 중요합니다. 이 원칙들은 기술 문서의 품질을 높이고, 독자와의 신뢰를 쌓는 데 필수적입니다. 하나씩 살펴보겠습니다.
2.1 명확성: 메시지를 단순하고 분명하게 전달하기
이 페이지의 컨텐츠
기술적 글쓰기의 첫 번째 목표는 독자가 "무엇을 말하려는 거지?"라는 의문을 갖지 않도록 하는 것입니다. 복잡한 주제라도 단순하고 분명하게 설명해야 합니다. 이를 위해 문장은 간단하게, 용어는 일관되게 사용하세요.
예를 들어, "본 장치는 다기능성을 갖춘 사용자 인터페이스를 제공함으로써 효율적인 작업 수행을 가능하게 한다"라는 문장은 너무 거창합니다. 대신 "이 장치는 간단한 인터페이스로 작업을 쉽게 처리할 수 있다"라고 쓰는 게 더 명확합니다. 독자는 “다기능성” 같은 추상적인 단어보다 "쉽게 처리"라는 구체적인 표현에서 더 많은 의미를 얻습니다.
팁: 글을 쓰고 나서 스스로에게 물어보세요. “이 문장을 처음 읽는 사람이 바로 이해할 수 있을까?” 만약 망설여진다면, 더 단순하게 바꿔보세요.
2.2 간결성: 불필요한 말을 줄이는 법
시간은 독자에게도, 여러분에게도 소중합니다. 기술적 글쓰기에서는 필요한 정보만 전달하고 불필요한 장식을 피해야 합니다. 긴 문장이나 반복적인 설명은 독자의 집중력을 떨어뜨리고, 중요한 메시지를 흐리게 만듭니다.
비교해보죠:
- 비간결: “사용자가 이 버튼을 누를 경우, 시스템은 데이터를 저장하기 시작하고, 저장이 완료되면 사용자에게 알림을 보내는 기능을 수행합니다.”
- 간결: “버튼을 누르면 시스템이 데이터를 저장하고 알림을 보냅니다.”
두 문장의 의미는 같지만, 두 번째 문장이 더 빠르고 효율적입니다. “시작하고”, “기능을 수행합니다” 같은 표현은 생략해도 뜻이 충분히 전달됩니다. 단, 간결함을 추구하다가 핵심 정보까지 빼버리지는 않도록 주의하세요.
2.3 정확성: 사실과 데이터의 중요성
기술적 글쓰기는 신뢰가 생명입니다. 부정확한 정보나 모호한 표현은 독자를 혼란스럽게 만들고, 최악의 경우 잘못된 행동으로 이어질 수 있습니다. 그러니 사실을 확인하고, 데이터를 명확히 제시하는 습관을 들여야 합니다.
예를 들어, "이 기계는 꽤 뜨거워질 수 있으니 주의하세요"보다는 "이 기계는 작동 시 최대 80°C까지 올라가므로 장갑을 착용하세요"가 훨씬 낫습니다. "꽤 뜨거워질 수 있다"는 모호하고 주관적인 표현이지만, "최대 80°C"는 구체적이고 측정 가능한 사실을 제공합니다.
작성 중이라면 참고 자료를 확인하고, 숫자나 세부 사항을 적을 때는 두 번 점검하세요. 작은 실수가 큰 오해로 이어질 수 있으니까요.
2.4 객관성: 편견 없는 글쓰기
기술적 글쓰기는 개인적인 의견이나 감정보다 사실과 논리에 기반해야 합니다. 독자는 여러분의 주관적인 판단이 아니라, 객관적인 정보를 원합니다. 특히 평가나 결론을 내릴 때는 근거를 제시하며 중립적인 톤을 유지하는 게 중요합니다.
예를 들어:
- 주관적: “이 소프트웨어는 정말 훌륭해서 모두가 좋아할 거예요.”
- 객관적: “이 소프트웨어는 95%의 사용자 만족도를 기록했으며, 주요 기능으로 빠른 처리 속도와 간편한 인터페이스를 제공합니다.”
첫 번째 문장은 감정적이고 과장된 느낌을 주지만, 두 번째 문장은 데이터와 사실로 뒷받침되어 신뢰감을 줍니다. 여러분의 역할은 독자가 스스로 판단할 수 있도록 정보를 제공하는 것이지, 대신 결론을 내려주는 게 아니라는 점을 기억하세요.
이 원칙들을 실천하려면?
이 네 가지 원칙은 서로 연결되어 있습니다. 명확하고 간결한 글이 정확성을 잃으면 무의미해지고, 객관성을 잃으면 신뢰를 잃습니다. 처음에는 이 모든 것을 동시에 적용하기 어려울 수 있습니다. 하지만 연습을 통해 자연스럽게 균형을 맞출 수 있을 겁니다.
작은 도전 과제를 드릴게요: 여러분이 최근 사용한 제품의 설명서를 떠올리고, 그 문서가 이 원칙들을 얼마나 잘 따랐는지 평가해보세요. 개선할 점이 있다면 어떻게 바꿀 건가요? 다음 장에서는 이 원칙들을 바탕으로 독자를 분석하고 글의 목적을 설정하는 방법을 더 깊이 알아보겠습니다.