개발자

주저리주저리

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

이번 글의 시작은 에러 메시지에 관한 내용이다. 사용자와 소통하는 에러 메시지 작성하기 웹 페이지에서 가장 자주 볼 수 있는 에러 404. 404 에러 화면에서도 사용자의 평가가 갈릴 수 있다. 구글의 404 화면을 보면 상당히 심플한데 이를 실제로 불편해하는 사용자도 있다. (사용자 본인이 링크를 잘못 입력한 것인지, 구글이 페이지를 삭제하는 바람에 에러 화면을 마주하게 된 것인지 모르기 때문) 반면, 위키피디아의 404 화면에는 사용자가 의도한 URL을 추측해서 제안하기도 한다. 친절하게도 우리나라의 경우에는 고객센터로 문의하는 링크가 포함되어 있는 경우가 대부분이다. 여기서 404 에러는 고객에게 죄송해야할까? 이것은 경우에 따라 다르다. 사용자가 URL을 잘못 입력한 경우에는 개발자가 죄송할 이유..

주저리주저리

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

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

주저리주저리

개발자 글쓰기의 중요성

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

BonusTrack02.dev
'개발자' 태그의 글 목록