TIL (Today I Learned)

// 2022.02.28.월

오늘 읽은 범위

// 5장. 형식 맞추기

책에서 기억하고 싶은 내용을 써보세요.

• 신문이 사실, 날짜, 이름 등을 무작위로 뒤섞은 긴 기사 하나만 싣는다면 아무도 읽지 않으리라. (p98)

• 가장 중요한 개념을 가장 먼저 표현한다. 가장 중요한 개념을 표현할 때는 세세한 사항을 최대한 배제한다. 세세한 사항은 가장 마지막에 표현한다. 그러면 독자가 소스 파일에서 첫 함수 몇 개만 읽어도 개념을 파악하기 쉬워진다. (p107)

• 좋은 소프트웨어 시스템은 읽기 쉬운 문서로 이뤄진다는 사실을 기억하기 바란다. 스타일은 일관적이고 매끄러워야 한다. 한 소스 파일에서 봤던 형식이 다른 소스 파일에도 쓰이리라는 신뢰감을 독자에게 줘야 한다. 온갖 스타일을 뒤섞어 소스 코드를 필요 이상으로 복잡하게 만드는 실수는 반드시 피한다. (p114)

오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요

• 나는 보통 형식에 맞춰서 짜지 않고 생각나는 대로 코딩을 하는 편이었다. 하지만 신문에 비유한 문장에서 무작위로 뒤섞인 신문은 아무도 읽지 않는다는 것을 본 후, 나였어도 안 읽을 것 같다는 생각이 들었고, 형식에 맞춰서 짜는 코드가 나 뿐만 아니라 다른 개발자들과의 의사소통에 중요하다는 것을 깨닫게 되었다.