내가 미래에 무언가가 막혔다면 .. 내가 미래에 무언가가 막혔다면 ..

Part 6명확하고 간결한 주석 달기 주석에 대한 좋은 정보들이 담겨있다. 함수의 동작을 실제로 할 수 있는 한도 내에서 최대한 명확하게 설명하라.신중하게 선택된 입/출력 예로 주석을 서술하라.코드가 가진 의도를 너무 자세한 내용이 아니라 높은 수준에서 개괄적으로 설명하라.많은 의미를 함축하는 단어로 주석을 간단하게 만들라. . 주석을 간결하게 하라 // int는 CategoryType이다.// 내부 페어는 첫 번째 float는 'score'이다.// 두 번째는 'weight'이다 // CategoryType -> (score, weight) . 동작을 명확하게 설명하라 // 이 파일에 담긴 줄 수를 반환한다.int CountLines(string filename) // 파일 안에 새 줄을 나타내는 바이..

Part 5주석에 담아야 하는 대상 주석을 잘 쓰지 않는다.그렇게에 더 열심히 읽어보자. 설명하지 말아야 하는 것.코딩을 수행하면서 머릿속에 있는 정보를 기록하기.코드를 읽는 사람의 입장에서 필요한 정보가 무엇인지 유추하기. 책에서는 간단한 이야기로 정의를 해두었다. . 나쁜 이름에는 주석을 달지 마라 - 대신 이름을 고쳐라. 생각을 기록하라 - (예/ 빠르다 무엇 때문에). 코드의 결함을 설명하라 - TODO 개선 아이디어. 상수에 대한 설명 (오해가 생기지 않게). 세부 사항을 설명하여 예측하자 (예/ 1분 이후 타임아웃) 읽기 좋은 코드가 좋은 코드다.더스틴 보즈웰, 트레버 파우커 지음 - 임백준 옮김한빛미디어

Part 4미학 코딩을 하면서 항상 예쁘게 표현하고 깔끔해야한다는 생각이 있었다.변수명을 이상하게 지어버리고는 깔끔떠는 ?이 파트에서는 내가 쉽게 읽고 지나가겠지 했지만 당연 아니었다. 코드를 읽는 사람이 이미 친숙한, 일관성 있는 레이아웃을 사용하라.비슷한 코드는 서로 비슷해 보이게 만들어라.서로 연관된 코드는 하나의 블록으로 묶어라. 1. 코드를 읽는 사람이 이미 친숙한, 일관성 있는 레이아웃을 사용하라. 첫 번째 주제는 많은 사람의 코드를 보아야만 알 듯 했다. unity를 이용한 게임을 제작할 때에는 독학이 위주였고동료나 친구들 역시 적은 경험을 통한 지식이었다. 자격증을 취득하고 다른 이의 코드를 보며간편하고 이해하기 쉬운 방식들을 찾아나아갔는데 이것도 하나이다. 미학적으로 보기 좋은 코드가 사..

Part 3오해할 수 없는 이름들 내가 가장 부족한 것이 이 점이라고 생각한다.이름을 짓고 나서 누군가가 이 의미를 이해할 수 있느냐 인데,부족한 점이라고 느끼게 되었다. 책에서는 간편한 단어들을 제시하였다.조금 더 찾아보며 적어두어야겠다. -- 번외로 변수명을 지어주는 사이트도 있으니 참고하자.http://www.curioustore.com/ * 경계 값 포함하는 한계값에는: min, max포함하는 범위에는: first, last배제하는 범위 : begin, end * Boolean 값 is(isOpaque)is + 명사: (무엇)인가 ?is + 현재진행형: ~하는 중 인가 ?is + 형용사: 수동태의 용어 (hidden, select 등) has(hasSpaceLeft)has + 명사: ~를 가지고 ..

Part 2이름에 정보 담기 함수명, 변수명을 짓는 것은 프로그래머가 가장 어려워하는 것.예전에 나는 이것이 농담이야, 장난처럼 던지는 말이지 !라고 말을 했었으나 이 글을 읽는 사람들이라면 다들 '요놈 짜식보게' 라고 말을 할지도 모른다. 이름에 정보를 담아내라.특정한 단어 고르기.보편적인 이름 피하기.추상적인 이름 대신 구체적인 이름 사용하기.접두사 혹은 접미사로 이름에 추가적인 정보 덧붙이기.추가적인 정보를 담을 수 있게 이름 구성하기. 차근차근 위의 문장들을 읽어보아야한다.가장 흔히 하는 나의 문제는 어느 한 단어에 꽂힌다는 것이다. 다른 사람의 코드를 보고나면 좋은 점을 배우고 돌아오는데항상 여기에서 꽂힌 단어는 계속 내 코드에 등장하기 마련이다. 한참 initialize 라는 단어에 빠져있을 ..

Part 1코드는 이해하기 쉬워야한다. 첫번째 파트를 읽는 순간 가장 먼저 떠오르는 두 가지가 있었다. 회사에서 가장 처음으로 차장님께 코딩을 배울 때는 전혀 부끄러운 점이 없었다.아는 것이 전혀 없어서였다고 하는게 정답일 것이다. 그렇게 배우기를 1년 하고도 반년이 지났을 무렵 스스로에게 처음으로 질문을 던졌었다.과연 이렇게 코딩을 하면 빠르게 실행이 될까 ?과연 다음 누군가에게 설명을 멋있게 할 수 있을까 ? 그에 대한 대답은 이미 정해져있었기에, 나는 가벼운 마음으로 자리에서 일어나 책가방을 짊어 메고 일어섰다. 코드는 이해하기 쉬워야한다.가독성의 기본정리.분량이 적으면 항상 더 좋은가 ?이해를 위한 시간은 다른 목표와 충돌하는가 ? 나는 이 질문에 예전 코드를 꺼내어 보려한다. 엄청 부끄럽다. 이..