https://alexnixon.github.io/2019/12/10/writing.html

https://news.hada.io/topic?id=2504 에서 알게 된 글. 아카이빙을 위해 요약 내용을 발췌했다.

파워 포인트는 해당 아이디어에 대한 꾸미기를 허용하고, 상대적으로 중요한 것들을 밋밋하게 하며. 아이디어의 연속성을 무시합니다.

기술자들이 피자를 중간에 놓고 이야기 하는 방식은 많은 지식을 얻는 데에는 유용하지만, 이야기는 중구난방으로 갑니다. 그래서 이 교착 상태를 깨기 위해서는 그 중 한 명이 비즈니스 요구에서 구현의 실용성까지, 포괄적이고 유동적이고 논리적인 방식으로 어떻게 해야하는 지에 대한 설명이 필요합니다.

그것을 다른 사람들에게 전해주기 위해서 작가는 해당 사항을 고려하여 적었을 것입니다.

  • 서문
    • 기술 변경 결정의 원인은? 왜 이게 가치있고, 어떤 이점이 있는가?
    • 이 특정 기술을 왜 솔루션으로 조사했는가? 조사할 만한 다른 대안은?
    • 해치워야 할 게 얼마나 많은가? 빌딩의 기초를 세워야 하는가, 자전거 정류소를 그려야 하는가? 만약 문제가 해결이 안 되면 변경은 쉬운가?
  • 본문
    • 제안된 기술에 꼭 치켜야 하는 내용이나 대원칙이 있는가? 그게 우리의 문제와 철학에 어떤 연관이 있는지?
    • 우리가 이걸 굴린다면, 어디가 최종목표인가? 구현이 끝나면 세상은 어떻게 변하는가?
    • 방해를 최소화하면서 현재 위치에서 목표 지점까지 어떻게 이동할 것인가? 전환 기간은 어느정도인가? 대락 얼마나 걸리는가?
    • 기존의 사내 전문 지식이 있는가?
    • 위험은? 이를 줄이기 위한 조치가 있는가? 미지의 미지수는?
    • 이 솔루션은 대체 솔루션보다 어떤 면에서 유리한가?
    • 대안이 이것보다 어떤 면에서 더 좋은가?
  • 결문
    • 근본적인 비지니스 요구와 권장 사항을 요약하고, 이게 왜 최선의 선택인지 설명.

TDD와 비슷하지만, TDD는 TDD를 위한 것으로 끝나는 데에 비하여 이런 설명문 쓰기는 재미있는 사이드 이펙트가 발생합니다. 저자의 마음 속에 남아 있는 생각입니다.

이 생각을 자연어로 번역한 후 다시 저자와 구두로 논의한다면, 아무런 문재가 없습니다. 그리고 글을 잘 작성하기 위해 이루어져야하는 여러 수준의 분석에서 문제를 고려한 후엔, 모든 관중의 수준에 맞게 설명을 조정할 수 있습니다.

마지막으로. 특수한 툴과 달리, 설명 ( 내러티브 ) 는 일반적입니다. 가장 좁은 기술적 문제부터 회사 전체의 사명과 목적에 관한 근본적 문제까지. 명확한 사고에 저항하는 문제는 없습니다.

104.
[2021.08.21]
노키즈존에 대한 인권위의 판단
103.
[2021.07.10]
급식실 노동자의 업무강도
102.
[2021.07.04]
차별을 없애기 위한 우대는 공평한 것이다
101.
[2021.06.16]
건강한 어른의 17가지 특성
100.
[2021.05.27]
교회가 구원받을 수 있을까?
99.
[2021.04.21]
결혼하면 매주 읽어야 할 글
98.
[2021.04.17]
이제부터 채식뿐이야
97.
[2021.04.15]
쭉정이 이론
96.
[2021.04.11]
실패에 우아할 것
95.
[2021.04.10]
이 땅에 임하실 하나님 나라
94.
[2021.04.05]
정경의 권위는 로마 황제로부터
93.
[2021.03.28]
개신교 극우주의와 차별금지법 - 김희현 목사
92.
[2021.01.24]
성녀 막달라 마리아
91.
[2020.10.30]
TDD는 끝없는 자기부정이다
90.
[2020.10.29]
The Twelve-Factor App
89.
[2020.10.26]
육하원칙이 아니라 5원칙이 필요하다
88.
[2020.10.15]
Interview-driven study
87.
[2020.09.20]
불신자가 읽는 성경
86.
[2020.09.01]
기독교 복음주의, 반동적인 초국가기구
85.
[2020.08.29]
종교가 돈이 되고 권력이 될 때, 신앙이란 이름으로 이성적 사고가 마비될 때
84.
[2020.08.28]
쿠팡 추천시스템 변천사
83.
[2020.08.25]
IntelliJ 2020과 QueryDSL 플러그인 문제
82.
[2020.08.09]
cherry-pick대신 rebase --onto
81.
[2020.08.07]
Java Reactive Stream 명세
80.
[2020.08.02]
Amazon Linux 2, Nginx, Let's Encrypt
79.
[2020.08.02]
웹 디자인 레퍼런스 모음
78.
[2020.07.28]
동시성 프로그래밍 게임
77.
[2020.07.27]
적정 수면시간은 더 잘 수 없을 때까지 자는 것이다
76.
[2020.07.22]
Kibun
75.
[2020.07.22]
파워포인트 대신 글쓰기로
74.
[2020.07.17]
컨볼루션
73.
[2020.07.14]
사용성
72.
[2020.07.13]
AWS Well Architectured Framework
71.
[2020.07.13]
안경 Plainbrand
70.
[2020.06.27]
국가기관의 성별선택란
69.
[2020.06.15]
이놈들아 미꾸라지 다 죽것다
68.
[2020.06.14]
css 기본 폰트 설정
67.
[2020.06.14]
메타 태그 정리
66.
[2020.06.13]
다크 모드 지원
65.
[2020.06.13]
Effective Java 원서로 다 읽었다
64.
[2020.06.08]
MBTI 전문가 발언
63.
[2020.05.16]
Java의 Cloneable 인터페이스
62.
[2020.04.28]
마틴 파울러의 Self Testing Code
61.
[2020.04.21]
추천 알고리즘과 텐서플로우
60.
[2020.04.19]
함수형 프로그래밍 레퍼런스
59.
[2020.04.19]
리눅스 예쁜 명령어
58.
[2020.04.15]
Spring 웹 컨트롤러 프록시
57.
[2020.04.13]
redux-toolkit과 typesafe-actions
56.
[2020.04.12]
VPC 이해하기
55.
[2020.04.12]
NIO가 성능이 좋은 이유
54.
[2020.04.11]
풀 스택과 NIO
53.
[2020.04.08]
Next.js v9.3 인증과 SSG
52.
[2020.04.04]
redux-observable
51.
[2020.04.04]
블로그 1.0 완성
50.
[2019.09.14]
49.
[2019.09.13]
혐오정치와 개신교
48.
[2019.09.12]
보이는 것은 실재가 아니다
47.
[2019.09.08]
인연 - 피천득
46.
[2019.06.09]
이건 하면서 저건 왜 안해요?
45.
[2019.05.13]
존재에 대하여 [有物]
44.
[2019.05.06]
죽편(竹篇) 1 - 여행
43.
[2019.05.05]
당신 인생의 이야기
42.
[2019.05.04]
41.
[2019.04.29]
有朋自遠方來 不亦樂乎
40.
[2019.04.27]
에고센트릭 시스템
39.
[2019.04.15]
서구가 만든 중동
38.
[2019.04.14]
나는 간호사, 사람입니다.
37.
[2019.04.12]
Our Planet
36.
[2019.04.11]
"불교에서는 생명 아닌게 없어"
35.
[2019.04.10]
볼링 100점
34.
[2019.04.09]
르몽드 디플로마티크 2월
33.
[2019.03.23]
32.
[2019.03.20]
부두
31.
[2019.03.15]
30.
[2019.03.11]
지옥
29.
[2019.03.06]
28.
[2019.03.05]
기본소득 → 무상 서비스
27.
[2019.03.04]
기술 도서
26.
[2019.03.03]
25.
[2019.03.02]
손 씻기
24.
[2019.03.01]
퍼블리2
23.
[2019.02.28]
책 읽기
22.
[2019.02.27]
퍼블리
21.
[2019.02.26]
위빠사나
20.
[2019.02.25]
다육이2
19.
[2019.02.24]
18.
[2019.02.23]
비극
17.
[2019.02.22]
간담회 후
16.
[2019.02.21]
누구인가?
15.
[2019.02.20]
팀원을 평가하는 세 가지 기준
14.
[2019.02.18]
감사의 글
13.
[2019.02.16]
파워풀
12.
[2019.02.15]
11.
[2019.02.14]
단조증가
10.
[2019.02.13]
퍼스날 데이타베이스
9.
[2019.02.11]
성찰하는 남자들
8.
[2019.02.10]
삶의 의미
7.
[2019.02.08]
6.
[2019.02.07]
버림받는다는 것
5.
[2019.02.06]
전문성
4.
[2019.02.05]
다육이
3.
[2019.02.04]
React
2.
[2019.02.03]
1.
[2019.02.02]
첫 번째 일기