이책을 읽은 이유
예전에 어른들이 성공하고 싶으면 책을 많이 읽으라고 말한 기억이 많다. 하지만 나는 이것을 23살이 될때까지 한번도 실천한 기억이 없다. 아니 알고 있어도 실천한 기억이 없다.
이것을 실천하려고 다짐하게 된 것은 엘리트라고 생각했던 내가 금리에 대해서도 모르고, 환율에 대해서도 이해 못하고, 연말정산도 잘 못하고, 공산당이나 민주주의 대해 정의도 못 내리고, 주식은 맨날 폭망하고, 결국 수박 겉핡기에도 못 미치는 지식으로 으쓱거리고 있었기 때문이다.
책은 이것을 매꾸기에 매우 좋은 기회이다 싶어 배우게 되었다.
5장 - 심플코드 통합하기
샘플코드의 유형
- 실행가능형
- 설명형
고객이 원하는 코드
- 문서 훑기
- 샘플 코드 찾기
- 샘플 코드의 개념 파악하기
- 복붙하기
- 샘플코드와 응답 예제가 일치
필수요소
- 설명이 제공됨
- 간결함
- 명확함
- 사용 가능함
- 신뢰할 수 있음
추가 요소
- 인라일 주석
- 코드 샌드박싱(시간과 노력 필요)
- 샘플 코드 자동 생성하기(Open API 사양)
6장 - 시각적 컨텐츠 제공하기
사진 한장 보는데 0.013초 = 글을 사진보다 더 잘 쓸 자신 없으면 사진 써라
사진 요소
- 이해 용이성 : 이 콘텐츠가 독자에게 도움이 되는가?
- 접근성 : 일부 독자에게 사용하기 어렵지는 않은가?
- 성능 : 콘텐츠의 크기와 포맷이 독자에게 도움이 되는가 이나면 방해가 되는가?
주의할점
- 화질이 클수록 문서가 로딩되는 속도에 영향을 미칠 수 있다.
- 메뉴 상단의 작은 톱니바퀴 이미지 -> 메뉴 상단에 작은 톱니바퀴가 있습니다. 다른 사람에게 이미지를 설명하는 어투로 작성
- 샘플 코드는 이미지 X
다이어그램
- 데이터베이스 -> API -> 클라이언트 -> 사용자
- 연결선은 엉키거나 크로스되지 않도록. 단방향 혹은 양방향만 제시.
- 병행 라인 X, 한라인만 설명
- SVG 포멧으로 이미지를 게시하기
비디오 컨텐츠
- 정말 필요한 것인지 생각하기
- 돈주고 전문가 부르기(기회비용)
7장 - 배포
- 일단 배포하고 생각하자.
콘텐츠 릴리스 프로세스
- 콘텐츠를 언제 배포하는것인가?
- 최종 검토와 배포는 누가 담당하는가?
- 콘텐츠를 어디에 배포할 것인가?
- 콘텐츠를 배포하려면 어떤 소프트웨어 도구가 추가로 필요한가?
- 새로운 콘텐츠를 사용자에게 어떻게 알릴 것인가?
단점:
- 설명이 어찌보면 당연하다는 것을 서술.
- 예시가 전무. 구체적인 통계가 전무