본문 바로가기
728x90

테크니컬 라이팅

 (310)
GitBook 레가시 이전하기 얼마 전부터 사용하던 GitBook 계정을 내년에 삭제할 예정이니 새로운 곳으로 옮기라는 메일이 왔더군요. 2016년에 잠깐 외부 스터디 참여하면서 정리한 내용을 기록하기 위해 가입하고 그 이후에는 전혀 관리를 하지 않고 있었는데, 벌써 시간이 이렇게 지나버렸네요. 보통 콘텐츠를 제공하는 서비스는 크게 변경된 것이 없다면 새로운 버전으로 업데이트를 해줄텐데, 뭔가 그 사이 많이 달라진 모양입니다. 레가시(?) 사이트는 https://legacy.gitbook.com/ 로 접속합니다. 뭐 지금 보더라도 사이트는 크게 나쁘지 않습니다. 2016년의 모습은 아닐 듯 하고, 아마 새로운 서비스로 옮겨가기 전의 모습이 아닌가 싶네요. 레퍼런스도 몇 개 없던 시절이었는데, 요즘에는 job info에 GitBook ..
[마소 V.396 리뷰] 영어로 커밋 메시지 쓰기 어렵지 않아요 커밋 메시지를 그렇게 주의 깊게 보는 개발자들이 있을까 싶고, 당장 나에게 급한 일은 아니라서 이 글은 그냥 넘어갈까 했는데 뒷부분에 JIRA 제목과 내용을 작성하는 가이드가 있더군요. 예전부터 고민하던 내용이라, 이 부분은 정독(?)을 했습니다. 지라 티켓은 제목(필드명: 요약)만 봐도 무슨 내용인지 혹은 무엇을 하겠다는 것인지 알 수 있도록 작성해야 한다. 사실 다들 알지만, 쉽지 않은 일입니다. 검색 기능을 사용해서 내용 검색이 가능하지만, 내용까지 검색하게 되면 불필요한 내용들도 나와서 제목에 딱 요구사항이 드러나는 것이 가장 좋다는 생각입니다만, 그걸 제목에 담아내는 것이 쉽지 않습니다. 그래서 이러이러해야 한다라고 이야기하는 것은 쉽지만, 어떻게 해야 하는 거야~라는 정답을 알려주는 것은 쉽지..
아이콘 색상 변경하기 아~ FlatIcon 사이트에 이런 기능이 있는 줄은 몰랐네요. https://www.flaticon.com/kr/free-icon/alarm_92386# Freepik이(가) 제작한 경보개의 무료 벡터 아이콘 SVG, PSD, PNG, EPS 형식 또는 웹 폰트 형태로 이 무료 아이콘을 다운로드하세요. Flaticon은 최대의 무료 벡터 아이콘 데이터베이스입니다. www.flaticon.com 원하는 아이콘을 일단 찾고 내려받기 전에 팔레트 비슷한 버튼을 클릭하면 색을 바꾸고 내려받을 수 있습니다. 간단하게 다른 색상 아이콘이 필요한 경우 유용하게 사용할 수 있겠네요. 무료 계정이라도 아이콘이 무료인 경우에는 그냥 사용할 수 있는 듯 합니다. 크기도 바꿀 수 있는데, 기본적으로 다양한 크기 내려받기를 ..
[마소 V.396 리뷰] 문서 엔지니어링과 API 문서화 요즘 살짝 관심있는 분야라 흥미롭게 읽다가 한 문장에서 딱 마음이 걸렸습니다. ...API 레퍼런스는 이를 사용하는 개발자가 가장 많이 보는 기술 문서이며, 문서 엔지니어링을 어떻게 하느냐에 따라 작성 시간 및 출력물 모양이 크게 달라진다. 이런 이유로 전문 테크니컬 라이팅팀을 보유한 회사라면 자체 API 문서화 솔루션을 가져야 한다고 생각한다. 완전히 새로운 도구를 만들어야 한다는 것이 아니라, 이미 있는 도구를 사용하더라도 트렌드 변화에 맞춰 정확하게 전문적인 결과물을 내놓는 프로세스를 가지고 있어야 한다는 뜻이다. 구글도 그렇고 마이크로소프트도 그렇다. LINE 역시 다르지 않다... 최근 오프라인으로만 제공하던 API 레퍼런스 게시를 처리하면서 몇몇 회사들을 조사해보았는데, 글쓴이가 이야기한것처럼..
[마소 V.396 리뷰] 문송한 국문과의 보안회사 입문기 문송하지 않는 경우라 하더라도 새로운 기술의 용어에 대한 어려움은 누구나 마찬가지일겁니다. 오히려 국문학을 공부한 분들이 더 유리하지 않을까 싶네요. 때문에 이 글은 전혀 공감되는 글은 아닙니다. 물론 다른 분야의 경우에는 전문적인 학회 등에서 용어를 정의하는 활동을 참 열심히 하고 있습니다. 그에 비해 IT 분야는 너무 빠르게 새로운 표현이나 기술이 등장해서 그런지 용어 정의에 대한 활동이 쉽지 않습니다. 이런 학회보다는 커뮤니티를 중심으로 또는 책을 번역하는 과정에서 용어가 정리되는 경우가 더 많지 않을까 싶습니다. 이 글에서는 독특하면서도 이런 경험이 있다 싶은 내용이 바로 키워드 검색입니다. 맞춤법에 맞지만 뭔가 맘에 들지 않는 경우 검색 결과에 의존하게 됩니다. "결과값"과 "결괏값" 같은 경우..
[마소 V.396 리뷰] 개발자의 새로운 도전 관점 바꾸기 저자의 명성(?)에 비해 너무 뻔한 이야기를 쓴 것이 아닌가 싶은 아쉬움이 있습니다. 하지만, 다양한 리소스를 예시로 들면서 이런 스토리를 엮어간다는 건 경험과 통찰력 그리고 노력이 뒤따르는 일이었겠지요. "번역가 모모씨의 일일"이라는 책에서 일부 내용을 인용해 개발자의 글쓰기에 비유한 이야기가 인상적이었습니다. 이 문장이 없었다면 리뷰를 쓰지 않았을지도 모르겠습니다. ...개발자의 1층은 갈고 닦은 개발 기술과 역량에 기반한 코드여야 한다. 꿈을 지켜주는 2층으로 책을 쓰거나 번역을 고려한다면, 읽기와 쓰기 훈련이 사건과 갈등, 문제 해결이 포함된 스토리를 만드는 최고의 스승이다. 기술자의 책은 전개되는 스토리 속에서 독자가 통제된 훈련 순서를 반복함으로써 일정한 수준의 기술을 익히도록 해야 한다. 따..
[마소 V.396 리뷰] 개발자 문서와 PMF 요즘은 RPA 솔루션들이 등장하면서 업무 담당자 스스로 업무를 자동화했다는 것이 그리 놀라운 일은 아닙니다. 하지만, 몇 년 전만 하더라도 현장에 있는 담당자가 코딩을 해서 업무를 개선했다는 건 엄청난 일이죠. 이 글에서 다루는 사건(?)은 언론에서도 꽤 오랫동안 이슈가 되었던 건이라 대략적인 이야기는 들은 기억이 납니다. 하지만 그 뒷이야기는 모르고 있었죠. 특히 처음에 브런치에 글을 쓰고 나서 실제 바이럴이 돌기 시작한 건 본인 스스로 유머 사이트에 글을 옮기고 나서였다니. 이건 좀 충격적이네요 ^^ ...내 글이 온갖 유머사이트에 공유되기 시작했다. 독자 대부분이 유머 사이트 사용자였다. 개발자들은 댓글에서 아는 척을 하거나 코드를 지적하는 경우가 더 많았으므로 과감하게 개발자 독자를 포기했다. 조..
최소 사양? 최저 사양? 명확하게 기준을 정하지 않으면 항상 혼란스러운 부분입니다. 일반적인 상황에서는 큰 문제가 되지 않지만, 게임처럼 높은 사양을 요구하거나, 기업 내에서 대량 구입한 장비에서 동작하는 앱에서 문제가 생길 수 있습니다. 일단 용어부터 보면 영어와 한국어 같은 경우는 아래와 같은 표현을 사용합니다. Minimum: 최소한 이 정도 성능을 가진 장비가 필요하다는 이야기죠. 우리말로 옮기면 "최저" 또는 "최소"로 옮길 수 있습니다. 여기서 혼란스러워지는 거죠. 또 "최소"라는 표현은 한자어에 따라 의미가 달라집니다. 그래서 아예 어떤 경우에 쓰는지 내용을 정리해놓았습니다. 그 내용을 보면 최소(最小) 또는 최저(最低)를 사용할 수 있을 듯 합니다. 만약 최소 또는 최저를 사용한다면 그 반대말도 맞게 쓰여야 합니다..
반응형

티스토리툴바