블로그 이미지
따뜻한 코드 만들기 리본매냐

카테고리

분류 전체보기 (34)
.NET (6)
Database (5)
Daily life (11)
세미나 후기 (0)
마음의 지식 (7)
코드 (1)
Python (1)
외출 (3)
Total41,952
Today16
Yesterday20

달력

« » 2019.8
        1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 31

공지사항

태그목록

1. 목적 : 오늘 구현한 코드의 가독성은 아픙로 바뀔 코드의 품질에 지대한 영향을 미친다.
             원활한 소통을 장려하는 코드 형식은?

2. 적절한 행 길이를 유지하라
   일반적으로 큰 파일보다 작은 파일이 이해하기 쉽다.
  
   신문 기사처럼 작성하라
   위 -> 아래
   이름은 간단하면서도 설명적으로 짓는다.
   파일 첫 부분은 고차원 개념과 알고리즘 설명 -> 의도를 세세하게 묘사 -> 마지막 : 가장 저차원 함수와 세부 내역

   개념은 빈 행으로 분리하라
   왼쪽 -> 오른쪽, 위 -> 아래
   각 행은 수식이나 절을 나타내고, 일련의 행 묶음은 완결된 생각 하나를 표현
   생각 사이는 빈 행을 넣어서 분리
   빈행은 새로운 개념을 시작한다는 시각적 단서

   세로 밀집도
   세로 여백이 개념을 분리한다면 세로 밀지보는 연과성

   수직 거리
   서로 밀접한 개념은 세로로 가까이 두어야한다. 두 개념이 서로 다른 파일에 속하다면 규칙은  통하지 않는다. 하지만 타당한 근거가 없다면 서로 밀접한 개념은 한 파일에 속해야한다.
   protected 변수를 피해야 하는 이유 중 하나

   변수 선언 : 변수는 사용하는 위치에 최대한 가까이 선언
   인스턴스 변수 : 클래스 맨 처음, 변수간 세로로 거리를 두지 않는다. (논쟁이 분분)

   변수 선언을 어디서 찾을지 모두가 알고 있어야한다.

   종속 함수 : 한 함수가 다른 함수를 호출한다면 두 함수는 세로로 가까이 배치
                    호출하는 함수를 호출되는 함수보다 먼저 배치

   개념적 유사성 : 어떤 코드는 서로를 끌어당긴다. 친화도가 높을수록 코드를 가까이 배치

   세로 순서 : 함수 호출 종속성을 아래 방향으로 유지
                    호출되는 함수를 호출하는 함수보다 나중에 배치
                    신문 기사와 마찬가지로 가장 중요한 개념을 가장 먼저 표현 
                    가장 중요한 개념을 표현할 때는 세세한 사항을 최대한 배제

3. 가로 형식 맞추기
    한 행은 가로로 얼마나 길어야 적당할까?
   
   가로 공백과 밀집도
   가로로는 공백을 사용해 밀접한 개념과 느슨한 개념을 표현

   가로 정렬
   필자는 유용하지 못하다고 생각함. 오히려 정렬하지 않으면 중대한 결함을 찾기 쉽다.

   들여쓰기
   계층 표현, 구조가 한눈에 들어온다.

4. 팀 규칙 : 팀은 한 가지 규칙에 합의해야한다. 좋은 소프트웨어 시스템은 읽기 쉬운 문서로 이뤄진다. 일관적이고 매끄러워야 한다. 
   





  
Posted by 리본매냐

최근에 달린 댓글

최근에 받은 트랙백

글 보관함