초보 개발자인 내가, 당신(개발자)이 나를 위해 쓴 튜토리얼을 읽는 방법

1 month ago 14

초보자가 개발자들이 작성한 기술 튜토리얼을 읽을 때의 혼란과 장벽을 유머러스하게 묘사한 글
개발자들이 흔히 사용하는 전문 용어와 약어는 초보자에게는 전혀 맥락 없는 ‘외계어’처럼 들림
튜토리얼의 설치 단계, 파일 경로, 터미널 명령어 등이 지나치게 복잡하거나 생략되어 이해하기 어려움
글쓴이는 개발자 시각에서는 당연한 설명이 초보자에게는 수 시간 검색과 시행착오를 요구하는 장애물이 된다고 지적함
이 글은 튜토리얼을 쓰는 개발자들에게 초심자의 관점에서 설명을 더 친절하고 명확하게 해야 함을 상기시켜줌

글의 배경과 문제의식

글쓴이는 개발자가 아닌 초보자로서 개발자들이 작성한 튜토리얼을 읽으며 겪는 경험을 서술함
튜토리얼에 등장하는 기술 용어와 도구 이름이 무슨 뜻인지 전혀 감이 잡히지 않는 상황을 풍자적으로 표현함
예: Hoobijag, Snarfus, Shamrock portal 같은 가상의 기술명을 사용해, 초보자 눈에는 모든 것이 복잡하게 보인다는 점을 강조함

원문 번역

“안녕! 나는 개발자야. 나의 관련 경험은 이래: 나는 Hoobijag로 코딩하고 가끔 jabbernocks도 쓰고, 물론 ABCDE++++도 하지 (하지만 절대 ABCDE+/^+는 아니야, 그건 말도 안 되지? 하하!) 그리고 Shoobababoo로 일하는 걸 좋아하고 가끔 kleptomitrons도 다뤄. 나는 Company[1]에서 Shoobaboo 관련 코드를 하게 되었고, 그게 나를 Snarfus로 이끌었어. 자, 시작해 보자!

이 튜토리얼에 대하여

나는 처음 Snarfus로 아주 간단한 것[2]을 하기 시작했는데, 쓰면 쓸수록 잠재력을 보게 되었어! chromus가 좀 뒤엉켜 있지만, 사실 굉장히 다목적이야. 그래서 나는 hoobastank 대신 quagmire로 pintafore를 argyling하기 시작했지! 미쳤지, 알아. 하지만 어느 정도는 작동했고, 사실 꽤 재미있었어… 큰 장벽을 만날 때까지: fisterfunk가 shamrock portal과 전혀 대화하지 않고, Snarfus로 beep-boops를 보내주지도 않는 거야! 물론, 그게 무슨 의미인지 알지[3]— 이제 전체 hoob-터널이 gramelions로 막혀 버렸어. 용납할 수 없지.

거의 포기할 뻔했지만, 그때 깨달았어: backside Snarfus stagnator를 backside shamrock Klingon troglodyte emulater에 연결하면 괜찮아! 모든 게 beep-boops와 ding-dongs 하면서, 드디어 튜토리얼의 실제 주제에 도달한 거야. 그리고 원하는 방식으로 아주 간단한 것을 할 수 있게 되었지! 꽤 멋지지[4].

그래서 설정 방법은 이래:

터미널에서 ajkl;gawgor;iqeg;iJLkqen. wl;R aw;oeiga 4648664 arjarwgj;llj;ja fadgfgajkljl; wlj;sdjk;lfas 입력
이제 folder/hidden/deep/in/the/file/system/surprise!.file로 가서 파일 내용을 복사해. 만약 그곳에 없다면, library/library/library/llibrary/liiiiiibrarrrary/llllliiiiibrary/hidden/hidden/hiding/you can’t find me/hidden/nope/never/hahahahereiam.file에 있을 수도 있어
다시 터미널로 돌아와 파일 내용을 붙여넣고, 64A786AGR45JAR; rdja;jg [[]][[]][[]][[]]][()()()()()()()(){{}{}{}|{}{|}{}{|}{ ////////////////!! !!!! !! //// !!! agjlkargji;lwej;OI [ASRGASG[]ASGDASG[]EAEadgasg[]EAGE[edaga][]ahgr-0-0=-0-=0-=0=0-0=-0-=0=-0-=0=-0=-0!!! 입력
Boop![5]
Snarfus를 열고 방금 만든 파일을 업로드해
그냥 재미 삼아, chronostatiomatrix의 sham을 해제하고 싶으면 —()()(]]asdg a=-do —cd go cd stay —sususudododo baby shark—][] 실행해도 돼. 선택 사항이야
끝!

어떻게 되는지 알려 줘. 혹시 누가 이 방식을 GewGawGamma나 ometer2.7과 함께 쓰는지도 궁금해.”