어렵게 쓰는 것은 '게으름'이고, 쉽게 쓰는 것이 '실력'이다

 

기술 블로그에 글을 쓰는 개발자들과 소통하다 보면 공통적인 걱정을 마주합니다. '너무 풀어서 쓰면 제 수준이 낮아 보이지 않을까요?'라는 불안이죠. 이런 심리 때문에 많은 작성자가 하얀 화면 앞에서 고뇌하다가 영어 약자와 전문 용어로 가득한 글을 선택하곤 합니다.

그들의 무의식 속에는 '어려운 글이 곧 전문성'이라는 공식이 자리 잡고 있습니다. 하지만 오랜 시간 글을 써온 전문가로서 단언컨대, 이는 전문성의 본질을 오해한 착각입니다.

읽는 이를 배려하지 않은 불친절한 글은 전문성의 상징이 아니라 오히려 본인이 내용을 충분히 소화하지 못했다는 증거일 때가 많습니다. 오늘은 왜 '쉽게 쓰는 능력'이 개발자의 가치를 결정짓는 진짜 실력인지 알아보겠습니다.

왜 우리는 자꾸 어렵게 쓰게 되는가?

심리학에는 '두드리는 자와 듣는 자'라는 유명한 실험이 있습니다. 한 사람은 익숙한 노래 리듬에 맞춰 책상을 두드리고, 다른 사람은 그 소리만 듣고 노래를 맞히는 실험입니다. 두드리는 사람은 머릿속에 멜로디가 생생히 흐르기에 상대방도 당연히 맞힐 거라 낙관하지만, 실제 정답률은 고작 2.5%에 불과했습니다.

내가 아는 것을 상대방도 알 거라는 착각, 이것이 바로 '지식의 저주'입니다. 기술 블로그를 어렵게 쓰는 작성자들은 대부분 이 저주에 걸려 있습니다. 수년간 공부해서 얻은 기술적 깨달음을 단 몇 줄의 전문 용어로 축약해 버리면서 독자도 나와 같은 고민의 시간을 통과했을 거라 착각합니다.

독자가 글을 이해하지 못하면 당신의 전문성을 동경하기보다 오히려 다가가기 어려운 심리적 거리감을 먼저 느끼게 됩니다. 지식의 문턱이 높아질수록 당신의 실력이 온전히 전달될 기회는 줄어들 수밖에 없는 이유입니다.

쉽게 쓰는 것이 왜 진짜 실력인가?

물리학자 리처드 파인만은 '초등학생에게 설명할 수 없다면 진정으로 이해한 것이 아니다'라고 말했습니다. 우리가 복잡한 기술을 단순하게 표현하는 데 인색한 이유는 사실 그 과정이 훨씬 더 어렵기 때문입니다.

어렵게 쓰는 것은 오히려 게으른 작업입니다. 이미 정의된 문장을 그대로 옮겨오면 그만이니까요. 하지만 그것을 '비즈니스 언어'나 '일상의 비유'로 바꾸는 것은 고도의 지적 노동을 요구합니다.

기술의 핵심 원리를 100% 장악해야만 본질을 꿰뚫는 비유를 찾을 수 있고, 무엇을 버리고 남길지 결정하는 '편집의 용기'가 생기기 때문입니다. 막힘없이 읽히는 글을 보면 독자는 작성자의 지식뿐만 아니라 그 밑에 깔린 탄탄한 내공을 느낍니다. 억지로 전문가처럼 보이려 애쓰지 않아도, 쉬운 설명 하나가 그 어떤 어려운 용어보다 확실한 실력의 증거가 되기 때문입니다.

글쓰기가 나의 몸값에 어떤 영향을 주는가?

어느 날 여러분의 기술 블로그를 인상 깊게 본 업체나 파트너사에서 미팅 제안이 왔습니다. 그런데 막상 만나서 이야기를 나눠보니 블로그 글처럼 어려운 전문 용어만 쏟아낸다면 상대방은 어떤 생각을 할까요? 십중팔구 '이분 실력은 좋은 것 같은데, 앞으로 같이 일하면서 소통하려면 꽤나 고생하겠는걸?'이라며 지레 겁을 먹을지도 모릅니다.

반면, 복잡한 시스템 구조를 '배달 앱에서 라이더가 배정되는 원리와 비슷해요'라고 단번에 이해시켜 주는 개발자가 있다면 어떨까요? 어려운 걸 쉽게 설명하는 모습에서 이 사람이 얼마나 이 프로젝트를 완벽하게 꿰뚫고 있는지, 그리고 상대방을 얼마나 배려하고 있는지 느끼게 됩니다.

연차가 쌓일수록 단순히 코드를 잘 짜는 것을 넘어 내가 만든 기술이 어떤 가치를 만드는지 주변에 설득하는 능력이 훨씬 중요해집니다. 기술 블로그는 바로 그 지점을 증명하는 공간이어야 합니다.

구체적으로 어떻게 바꿔 써야 하는가?

그렇다면 전문성을 잃지 않으면서도 글의 문턱을 낮추려면 어떻게 써야 할까요?

가령, 여러 서버에 데이터를 안전하게 나누어 저장하는 기술을 설명할 때 보통은 'MSA 환경에서 데이터 정합성을 위해 Saga 패턴과 2PC 프로토콜을 구현하여 노드 간 원자성을 보장한다'고 적곤 합니다.

이 문장을 '서버가 여러 개로 쪼개져 있어도 데이터가 꼬이지 않게 보호합니다. 마치 여러 명이 무전기로 확인하고, 버튼을 누르는 것처럼 모든 서버가 합의했을 때만 정보가 저장되게 설계했습니다'라고 풀어서 쓰면 훨씬 직관적으로 상황이 머릿속에 그려집니다.

예를 들어, 가상화를 설명할 때도 마찬가지입니다. '커널 레벨의 네임스페이스와 cgroups를 활용해 프로세스 간 격리 환경을 구축한다'는 딱딱한 정의는 잠시 내려놓아도 좋습니다.

대신 '내 컴퓨터에서만 잘 돌아가고 남의 컴퓨터에서는 안 돌아가는 문제를 해결했습니다. 이사 갈 때 모든 짐을 박스에 넣어 통째로 옮기는 것과 같습니다. 어디에 실어도 박스 안의 상태는 똑같이 유지되니까요'라고 비유를 들어주는 것이 훨씬 효과적입니다.

중요한 건 용어를 나열하는 것이 아니라 이 기술이 어떤 문제를 해결하는지를 독자의 눈높이에서 보여주는 것입니다. 이렇게 쓴 글은 실무자에게는 작성자의 깊은 내공을 전달하는 힘을 가지고, 기술을 모르는 결정권자에게는 신뢰를 줍니다.

우리가 꼭 가져야 할 마음가짐은 무엇인가?

기술 블로그를 쉽게 쓴다는 건 단순히 글솜씨의 문제가 아닙니다. '나는 내 지식을 뽐내기보다 당신의 문제를 함께 해결하고 싶다'는 진심을 전하는 일이죠.

전문가라는 틀에 갇혀 어려운 말로 자신을 방어할 필요는 없습니다. 오히려 그 틀을 깨고 독자가 이해할 수 있는 언어로 다가갈 때 글쓴이의 전문성은 비로소 상대방에게 실질적인 도움으로 다가갑니다.

가장 쉬운 글이 가장 깊은 이해도를 증명한다는 사실을 꼭 기억하세요. 그 배려 섞인 노력이 여러분을 어디서든 함께 일하고 싶은 대체 불가능한 전문가로 만들어줄 것입니다.