본문내용 바로가기
MD의선택 무료배송 이벤트 소득공제

개발자의 글쓰기 변수 네이밍부터 릴리스 노트, 장애 보고서, 기술 블로그까지! | 프로그래머의 글쓰기 고민 끝!

김철수 지음 | 위키북스 | 2019년 10월 04일 출간
| 5점 만점에 5점 리뷰 2개 리뷰쓰기
  • 정가 : 18,000원
    판매가 : 16,200 [10%↓ 1,800원 할인]
  • 통합포인트 :
    [기본적립] 900원 적립 [5% 적립] [추가적립] 5만원 이상 구매 시 2천원 추가적립 안내 [회원혜택] 실버등급 이상, 3만원 이상 구매 시 2~4% 추가적립 안내
  • 추가혜택 : 포인트 안내 도서소득공제 안내 추가혜택 더보기
  • 배송비 : 무료 배송비 안내
  • 배송일정 : 서울특별시 종로구 세종대로 기준 지역변경
    지금 주문하면 내일(11일,토) 도착 예정 배송일정 안내
  • 바로드림 : 인터넷으로 주문하고 매장에서 직접 수령 안내 바로드림 혜택
    휴일에는 바로드림 픽업으로 더 빨리 받아 보세요. 바로드림 혜택받고 이용하기

이 책의 이벤트 해외주문/바로드림/제휴사주문/업체배송건의 경우 1+1 증정상품이 발송되지 않습니다.

  • 개발자로 입문하기: 일단 이것부터 읽어보자!
    2019.05.31 ~ 2020.12.31
  • 위키북스의 도서를 한 눈에 살펴보세요
    2017.11.23 ~ 2020.12.31
상품상세정보
ISBN 9791158391744(1158391749)
쪽수 276쪽
크기 152 * 210 * 20 mm /476g 판형알림

책소개

이 책이 속한 분야

이 책의 주제어

오직 개발자를 위한 글쓰기의 모든 것을 담았습니다!

이 책은 개발자의 글쓰기 능력을 종합적으로 향상하기 위한 책이다. 코드 안에서는 함수와 변수 이름을 짓는 것부터 주석 쓰는 법, 에러 메시지 쓰는 법까지 알려준다. 코드 밖에서는 릴리스 노트, 장애 보고서, 개발 가이드를 어떻게 하면 잘 쓸 수 있는지를 알려준다. 외주 개발을 하는 개발자를 위해 SI 제안서의 기술 부문을 설득력 있게 쓰는 법도 놓치지 않았다. 블로그를 운영하려는 개발자나 IT기업을 위해 기술 블로그를 쓰는 법과 운영하는 팁도 담았다.

상세이미지

개발자의 글쓰기 도서 상세이미지

저자소개

저자 : 김철수

한양대 국문과를 졸업하고 개발자, 기획자, 컨설턴트, 강사 등으로 불리며 벤처에서 대기업까지 다양한 회사와 직종에서 20년을 일했다.
코오롱 그룹 IT계열사 코오롱베니트㈜에서 공공 SI 프로젝트 PM도 하고 에너지 관리 솔루션도 개발하고 코오롱그룹의 “Industry 4.0 동향보고서” 편집장도 했다. 그 전에는 벤처기업 ㈜프리챌에서 아이템사업부장으로 일했고, 텍스트 분석 솔루션을 개발하는 스타트업 등에서 서비스를 기획하고 개발했다. 그때 첫 책으로 웹2.0과 서비스 기획을 다룬 『싸이월드는 과연 다음을 넘어섰을까?』를 출간했다.
지금은 모바일 퀴즈 애플리케이션과 콘텐츠 큐레이션 서비스를 개발해 운영하면서 AI 기반 실내 환기 알고리즘을 연구하고 있다. 개발 중에 틈틈이 글을 써서 인공지능 시대에 생각의 생산성을 높이는 방법을 다룬 『생각경영법』과 『팀장을 위한 보고서 검토 기술』 같은 책도 썼다. 비즈니스 글쓰기, 테크니컬 라이팅, 디지털 역량, 신사업 기획을 주제로 강의와 컨설팅을 하고 서울창의혁신투어 프로그램도 만들어 진행한다.

목차

▣ [프롤로그] 개발자의 글쓰기는 달라야 한다
개발자는 글을 못 쓴다?
개발자 글쓰기의 특징: 정확성, 간결성, 가독성
개발자의 글쓰기

▣ 1장: 개발자가 알아야 할 글쓰기 기본
01 문장과 단락을 구조화하는 법
___문장을 구조화하는 법
___서술식, 개조식, 도식의 차이
___개조식 서술 방식과 글머리 기호
___단락을 구조화하는 위계
02 쉽게 쓰는 띄어쓰기와 문장 부호
___가장 쉬운 띄어쓰기 원칙
___오해하기 쉬운 문장 부호(큰따옴표, 작은따옴표)
03 영어 단어 선택과 외래어 표기법
___비슷한 듯 다른 듯, 단어 선택
___외산 제품 표기와 외래어 표기법

▣ 2장: 개발 시간을 줄여주는 이름 짓기와 주석 쓰기
01 네이밍 컨벤션, 이유를 알고 쓰자
___개발자의 가장 큰 고민은 이름 짓기
___이름 짓기는 창조가 아니라 조합
___코드의 네이밍 컨벤션은 영어 표기법을 상속받았다
___파스칼 표기법으로 클래스 이름 짓기
___카멜 표기법으로 함수?변수의 이름 짓기
___상수는 모두 대문자로 쓴다
___패키지와 모듈은 모두 소문자로 쓴다
___BEM 표기법
___가독성과 소통이 먼저다
02 변수 이름을 잘 짓는 법
___i는 변수 이름이지만 d는 아니다
___긴 이름? 짧은 이름? 검색 잘 되는 이름!
___복수형을 나타내는 s를 붙일까 말까?
___약어를 쓰는 것이 좋을까? 안 쓰는 것이 좋을까?
___중요한 단어를 앞에 쓴다
___함수 이름 짓는 순서
03 좋은 이름의 기준, SMART
___한 번에 좋은 이름을 지을 수는 없다
___좋은 이름이 가진 5가지 특징
___easy to Search: 검색하기 쉽게 이름 짓는 법
___easy to Mix: 조합하기 쉽게 이름 짓는 법
___easy to Agree: 수긍하기 쉽게 이름 짓는 법
___easy to Remember: 기억하기 쉽게 이름 짓는 법
___easy to Type: 입력하기 쉽게 이름 짓는 법
04 좋은 코드에는 주석이 없다?
___이름을 잘 지으면 주석을 줄일 수 있다
___처음부터 주석 없이 코딩하는 연습을 하자
___주석이 필요한 때도 많다
05 다른 개발자를 배려하는 주석 쓰기
___코드는 의미를, 주석은 의도를
___주석의 반복
___주석의 발췌와 요약
___주석도 코드다

▣ 3장: 사용자와 소통하는 에러 메시지 쓰기
01 에러 메시지를 쓰기 전에 에러부터 없애자
___친절한 404, 불친절한 404
___404 에러가 죄송할 일인가?
___깨진 링크는 개발자의 책임이다
___개발자용 에러 메시지와 사용자용 에러 메시지를 분리하자
02 사용자 에러 메시지를 제대로 쓰는 법
___사용자 에러에 대처하는 메시지
___에러 메시지를 보여주는 순서
___오락가락 메시지와 버튼 메시지
03 사용자의 에러를 줄이는 메시지 구조화
___버튼의 순서
___사용자의 반복 에러를 막는 법
04 에러 메시지 대신 예방 메시지를 쓰자
___서비스를 이해하면 에러를 예방할 수 있다
___사용자를 이해하면 에러를 예방할 수 있다.
___닭이 먼저? 알이 먼저?

▣ 4장: 독자 관점에서 릴리스 문서와 장애 보고서 쓰기
01 체인지 로그를 분류, 요약, 종합하는 법
___체인지 로그의 양과 만족도의 관계
___1단계: 선정하기
___2단계: 분류하기
___3단계: 요약하기
___4단계: 종합하기
02 고객에게 유용한 정보를 쓰자
___개발자 관점과 고객 관점
___과거를 리뷰하고 미래를 보여주자
___Semantic Versioning(유의적 버전)
03 릴리스 문서는 문제 해결 보고서처럼 쓰자
___문제와 문제점을 구별하자
___문제, 문제점, 해결책, 후속 계획 순으로 적자
___법적인 문제를 고려해서 쓰자
04 비즈니스를 이해하는 장애 보고서 쓰기
___장애 보고서의 특징
___질문에 대답하는 신속한 글쓰기
___원인과 이유를 찾는 분석적 글쓰기
___상사를 고려하는 비즈니스 관점의 글쓰기
___원하는 것을 얻는 정치적 글쓰기

▣ 5장: 설명, 묘사, 논증, 서사로 개발 가이드 쓰기
01 서비스 개념을 범주, 용도, 특징으로 설명하자
___범주, 용도, 특징
___범주를 정확하고 적절하게 선택하자
___용도를 범주의 핵심 기능으로 기술하자
___특징을 장점과 강점에서 뽑아 쓰자
02 정확히 이해하도록 그림과 글로 묘사하자
___글에 묘사를 더하면 이해가 빠르다
___글과 그림의 내용을 일치시키자
___객관적 묘사와 주관적 묘사 둘 다 하자
03 논증으로 유용한 정보를 제공하자
___의견을 쓰려면 근거를 대자
___거칠게도 공손하게도 쓰지 말자
___주장과 이유의 거리를 좁혀서 쓰자
___문제와 답의 거리를 좁혀서 쓰자
04 서사를 활용해 목차를 만들자
___개발과 서사
___독자의 수준 대신 기술의 범용성을 기준으로 쓰자
___순서에서 단계를, 단계에서 목차를 만들자

▣ 6장: 수주를 돕는 SI 제안서 쓰기
01 개발자가 알아야 할 제안서 작성 원칙
___개발자와 제안 PM의 차이
___시스템 구성도의 본질은 그림이 아니다
___첫째, 제안요청서 분석
___둘째, 논리적 완결성
02 고객의 문제 인식과 제안사의 문제 해결 능력
___문제 인식과 문제 해결 능력
______① 경쟁사와 비교하여 제안하라
______② 일단 동감하고 다른 방안을 제시하라
______③ 고객이 문제를 중대하게 인식하게 만들어라
______④ 경쟁사의 전략을 확인해서 대처하라
03 고객의 요구사항은 변할 수밖에 없다
___개발은 고객 요구 실현
___요구사항을 분석하지 말고 제시하라
___변화하는 요구사항에 대비하라
04 고객의 총 만족도를 높이자
___요구라고 다 같은 요구가 아니다
___카노 모델로 본 요구의 세 가지 종류

▣ 7장: 기술 블로그 쉽게 쓰고 운영하기
01 기술 블로그를 쉽게 쓰는 방법 3가지
___개발자가 기술 블로그를 잘 못 쓰는 이유
______첫째, 주제 의식을 버리고 소재 의식으로 쓰자
______둘째, 독자 수준이 아니라 자기 수준으로 쓰자
______셋째, 재미있게 글을 쓰자
02 글의 종류별로 목차 잡는 법 I - 저술
___기술 블로그의 4종류, 저, 술, 편, 집
______저: 개발기는 목차를 잘 잡아서 본문부터 쓰자
______술: 원전을 비교하고 실험해 풀이해서 쓰자
03 글의 종류별로 목차 잡는 법 II - 편집
______편: 순서를 요약하여 쓰자
______집: 글쓰기가 두렵다면 자료를 모아 핵심을 엮어서 쓰자
04 기업의 기술 블로그 운영 팁
___기술 블로그는 회사의 가치를 높인다
___기술 블로그도 투자를 해야 살아난다
___개발자의 글쓰기는 회사의 문화를 반영한다
___협업해서 글쓰기, 짝 글쓰기를 해보자

▣ [애필로그] 회사가 개발자 글쓰기 교육을 하자

북로그 리뷰 (2) 전체보기 쓰러가기

도서 구매 후 리뷰를 작성하시면 통합포인트를 드립니다.
결제 90일 이내 작성 시 300원 / 발송 후 5일 이내 작성시 400원 / 이 상품의 첫 리뷰 작성 시 500원
(포인트는 작성 후 다음 날 적립되며, 도서 발송 전 작성 시에는 발송 후 익일에 적립됩니다.
외서/eBook/음반/DVD/GIFT 및 잡지 상품 제외)
안내
  •   개발자는 본업에서 가장 중요하다고 볼 수 있는 '코드'를 써야 하는 사람이다. 저자는 일반 글쓰기와 개발자가 써야 하는 글의 차이점을 시작으로 개발자의 글쓰기 가이드를 제시한다. 본인은 아직 주니어 개발자이기에, 신입의 기준에서 책을 읽으며 느낀 점을 정리해봤다.   구현에만 급급한 신입은 코드를 잘 못쓸 때가 많다 (물론 신입만이 아니다). 순간 떠오르는 단어를 조합으로 변수와 함수명을 지을 때가 많다. 또한, 어떤 때는 이렇게 다른 때는 저렇게 개성이 묻어 나오게 이름을 지을 때가 많다. &nbs... 더보기
  • 개발자의 글쓰기 제목부터 명확하다. 많은 공대생이 글쓰기에 어려움을 느낀다고 한다. 비단 공대생의 문제는 아니라고 생각한다. 하지만 문과생은 뭔가 좀 더 책을 많이 읽고 글 쓰는데 익숙하다는 이미지가 있다. 반대로 공대생은 수식이나 과학에 관심이 많고 글쓰기는 잘하지 못한다는 인식이 있다. 아닌 땐 굴뚝에 연기 나랴. 아마 공대생들이 글쓰기를 싫어하는 비율이 더 높다는 경험적인 통계가 있었을 것이다. 그래서일까? 요즘 학교 수업에도 공학 작문과 같은 공대생을 위한 글쓰기 수업이 있다. 공대생도 글쓰기가 필요하다는 의... 더보기

Klover 평점/리뷰 (0)

문장수집 (0) 문장수집 쓰기 나의 독서기록 보기
※구매도서의 문장수집을 기록하면 통합포인트 적립 안내

교환/반품/품절안내

※ 상품 설명에 반품/교환 관련한 안내가 있는 경우 그 내용을 우선으로 합니다. (업체 사정에 따라 달라질 수 있습니다.)

교환/반품/품절안내
반품/교환방법 마이룸 > 주문관리 > 주문/배송내역 > 주문조회 > 반품/교환신청 ,
[1:1상담>반품/교환/환불] 또는 고객센터 (1544-1900)

※ 오픈마켓, 해외배송주문, 기프트 주문시 [1:1상담>반품/교환/환불]
    또는 고객센터 (1544-1900)
반품/교환가능 기간 변심반품의 경우 수령 후 7일 이내,
상품의 결함 및 계약내용과 다를 경우 문제점 발견 후 30일 이내
반품/교환비용 변심 혹은 구매착오로 인한 반품/교환은 반송료 고객 부담
반품/교환 불가 사유
  • 소비자의 책임 있는 사유로 상품 등이 손실 또는 훼손된 경우
    (단지 확인을 위한 포장 훼손은 제외)
  • 소비자의 사용, 포장 개봉에 의해 상품 등의 가치가 현저히 감소한 경우
    예) 화장품, 식품, 가전제품(악세서리 포함) 등
  • 복제가 가능한 상품 등의 포장을 훼손한 경우
    예) 음반/DVD/비디오, 소프트웨어, 만화책, 잡지, 영상 화보집
  • 소비자의 요청에 따라 개별적으로 주문 제작되는 상품의 경우 ((1)해외주문도서)
  • 디지털 컨텐츠인 eBook, 오디오북 등을 1회 이상 다운로드를 받았을 경우
  • 시간의 경과에 의해 재판매가 곤란한 정도로 가치가 현저히 감소한 경우
  • 전자상거래 등에서의 소비자보호에 관한 법률이 정하는 소비자 청약철회 제한 내용에
    해당되는 경우
(1) 해외주문도서 : 이용자의 요청에 의한 개인주문상품으로 단순변심 및 착오로 인한 취소/교환/반품 시 ‘해외주문 반품/취소 수수료’ 고객 부담 (해외주문 반품/취소 수수료 : ①양서-판매정가의 12%, ②일서-판매정가의 7%를 적용)
상품 품절 공급사(출판사) 재고 사정에 의해 품절/지연될 수 있으며, 품절 시 관련 사항에 대해서는
이메일과 문자로 안내드리겠습니다.
소비자 피해보상
환불지연에 따른 배상
  • 상품의 불량에 의한 교환, A/S, 환불, 품질보증 및 피해보상 등에 관한 사항은
    소비자분쟁해결 기준 (공정거래위원회 고시)에 준하여 처리됨
  • 대금 환불 및 환불지연에 따른 배상금 지급 조건, 절차 등은 전자상거래 등에서의
    소비자 보호에 관한 법률에 따라 처리함

이 분야의 베스트

  • 김정준
    29,700원
  • 윤인성
    16,200원
  • 조블리(조애리)
    20,700원
  • 찰스 펫졸드
    22,500원
  • 천인국
    24,000원
더보기+

이 분야의 신간

더보기+

바로가기

  • 우측 확장형 배너 2
  • 우측 확장형 배너 2

최근 본 상품