주저리주저리

주저리주저리

개발자의 글쓰기를 읽고 나서(2)

저번에 예고했던 대로 변수와 함수 이름을 짓는 법을 소개하는 것으로 이번 글을 시작하도록 하겠다. 변수 이름 짓기 우리는 흔히 반복문이나 배열 인덱스에 i라는 변수를 자주 사용한다. 이는 integer나 index의 첫 글자로 간주되므로 이상할 것이 없다. 하지만, d라는 변수가 있다면 해당 코드를 읽는 사람은 어떻게 받아들여야 할까? day? double? date? 책에서 소개하길 일자를 뜻하는 변수를 설정하고 싶다면 그냥 day를 사용하면 된다. 하지만, 우리가 어떤 프로그램이던 그냥 day란 없을 것이다. today? selectedDay? finalDay? 등 특정한 의미를 부여해 사용해야 한다. 변수 이름을 지을 때 고려할 또 하나의 척도가 있다. 바로, 검색이 용이한 이름이다. IDE가 발전..

주저리주저리

디지털 세계에서 아날로그의 중요성

가장 먼저 이 글은 의식의 흐름 그대로 적을 예정이기에 어떠한 질서도 없을 예정이다. 글의 제목은 다른 직종보다 디지털에 가까운 내가 요즘 느끼는 감정이다. 내가 원래 되고 싶었던 인간상이기도 하다. 디지털에 둘러싸여 있어도 그 속에서 아날로그의 무언가를 첨가할 수 있는 그런 사람. 그나마 유명한 사람이라고 하면 로스트아크 금강선 디렉터를 아주 좋은 예로 들 수 있겠다. 게임을 개발하는 사람이라지만 그 사이에서 사람들을 매료시킬 수 있는 언변, 글솜씨 등이 정말 존경스럽다. 보통 사람들은 아주 치밀하게 손익을 계산하며 지내고 있었지만 낭비없는 낭만은 없다고 말할 수 있는 사람. 어떤 것이 불편한지 공감할 수 있는 사람. 진짜 공감을 통해 사람들을 진정시킬 줄 아는 사람. 게임 내 특정 기능이 불편할 때 ..

주저리주저리

개발자의 글쓰기를 읽고 나서(1)

나는 이번 시리즈를 책의 순서대로 소개해보려 한다. 책의 모든 내용을 소개하진 않을 것이고 내 마음에 남았던 부분만을 적어볼 예정이다. 먼저, 이 책은 신기하게도 내가 가장 관심있어하던 부분을 위한 빌드업부터 시작한다. 정말 놀라웠던 문장은 내가 어느 유튜브에서 보고 깊게 공감했던 내용이었는데 아래와 같다. 코딩도 결국 글쓰기와 같다. 솔직히 말하면 어떤 다른 문장도 이 문장을 이길 수 없을 것이다. 모든 문장을 대변하는 한 줄이다. 이 다음은 글쓰기 기본에 대해 소개하고 있는데, 글의 독자가 누구인지, 그에 따라 문장이 어떻게 구성되어야 하는지 생각해야 한다. 특히 개조식 글에는 글머리 기호를 써야한다. 다들 아는 네모나 동그라미 등이 예시일 것이다. 같은 챕터에서 글쓰기와 코드를 작성할 때 어떤 원칙..

주저리주저리

개발자 글쓰기의 중요성

최근 나와 부장님을 동시에 이마를 짚게 하는 문제가 생겨서 포스팅해본다. 다른 회사와 나름 '협업'이라는 것을 하면서 메일이나 카톡을 주고 받는 일이 생기곤 한다. 이번 사건(?)은 외부 업체의 기가 막힌 글쓰기로 인해 비롯되었다. 발단 외부 업체에서 개발한 앱이 우리 회사에서 개발한 앱을 딥링크로 호출하는 상태이다. (이제 외부 업체를 A사라고 칭하겠다) 아이디/ 비밀번호 찾기 버튼 클릭 시, A사에 API 요청을 통해 링크를 받아와 해당 링크를 웹뷰로 보여준다. (여기서 이해가 되지 않는 부분은 이미 프로덕션 트랙으로 릴리즈가 되었는데 해당 링크가 유효하지 않아 웹뷰는 에러를 보여주고 있다.) 부장님과 A사의 카톡방에서 A사가 아이디/ 비밀번호 찾기 링크가 변경되었다고 공지했다. 그리고 A사가 보낸 ..

주저리주저리

최근 느낀 일할 때 하지 말아야 할 것

1. 자신만의 언어 사용 여러 글에서 많이 소개된 내용이지만 최근 갑작스럽게 확 체감이 된 것이다. 그 이유는 최근 회사에서 여러 팀, 다른 회사와 협업해 진행하는 업무가 이어졌는데 이 때, 우리 회사의 다른 팀 개발자 분이 본인만의 언어를 남발하셨다. 그래서, 우리 회사의 기획팀에서는 말 자체에 대해 이해를 못하셨다. (아무리 기획팀이 개발을 모르셔도 기본 시나리오는 파악하고 계셨다) 예를 들자면 이런 말들이었다. 우리가 서버에 ~을 쏜다 서버에서 받은 거 그대로 ~에 던진다 계속 서버에 날린다 이러면 안 붙는다 이 상황이면 붙었네 사실 내가 쓰면서도 어질어질한데... 이런 문장에서 대부분 주어가 없다면 그 누가 알아듣겠는가 싶다. 나는 그래서 최대한 공식적인(?) 용어를 사용하려고 노력했다. 아래와 ..

BonusTrack02.dev
'주저리주저리' 카테고리의 글 목록 (2 Page)