제 5장. 예

제 4장. 수식과 명제보다 제 5장을 먼저 읽은 관계로 5장을 먼저 포스팅한다.

 

기본

1. 전형적인 예를 사용한다.

전형적인 예를 먼저 사용하고, 극단적인 예시를 사용한다.

글쓴이 사견 : 예시 코드를 작성할 때 일반적인 기능에 대한 구현을 예로 들면 더 효과적이겠다.

 

2. 들어맞는 예 -> 들어맞지 않는 예를 기술한다.

들어맞는 예와 들어맞지 않는 예는 비슷하지만 다른 성질을 갖는 예를 들면 좋다. 두 예가 아예 동떨어지면 본 개념에 대한 이해가 흐려질 수 있다.

 

3. 일반적인 예를 사용한다.

특수한 조건이 붙는 예를 활용하지 않는다.

 

4. 독자의 지식을 고려한 예를 사용한다.

글을 읽을 독자들이 알고 있는 배경 지식을 고려한다. 독자들에게 알기 쉬운 것, 익숙한 것, 알고 있는 것으로부터 예를 만든다.

 

설명과 예의 대응

1. 예는 내용에 대응한다.

설명하는 내용과 사용한 예를 대응시켜야 한다.

예를 들어 실컷 성능 최적화에 대한 설명을 먼저 해놓고 예시로는 리팩터링을 들면 혼란스러울 수 밖에 없다.

 

2. 예는 표기에 대응한다.

설명에서 사용한 표기와 예에서 사용한 값의 표기를 대응시킨다.

Observable A를 

 

3. 내용의 처음과 끝에 예의 존재에 대한 소개와 확인을 명확히 한다.

처음

구체적인 예는 다음에 제시합니다.

끝

이것은 ~의 예입니다.

 

예를 만들 때 마음가짐

1. 내가 알고있는 지식을 과시하지 않는다.

'이 예는 독자의 이해를 돕는가'를 생각한다.

 

2. 자신의 이해가 정확한지 의심한다.

 

자신이 잘 이해하고 있는지 아닌지를 확인하고 싶다면
예를 만들어보자
예를 만들 수 있다면 당신은 이해하고 있는 것이다
예를 만들 수 없다면 당신은 이해하지 못한 것이다