refactor: 문서 사람처럼 작성하기
This commit is contained in:
+6
-6
@@ -19,7 +19,7 @@ source:
|
||||
|
||||
격자와 열을 재고 「정상」이라고 답했는데, 전체 페이지 스크린샷을 찍으니 제목이 26px 에 굵기 400 이었다. 목록 간격을 바운딩 박스로만 재서 엉뚱한 곳을 결함으로 지목한 적도 있다. 화면이 잘못됐다는 보고는 보이는 것을 재서 확인한다.
|
||||
|
||||
## 관계
|
||||
## 간접 지표와 사용자가 보는 결과는 다를 수 있다
|
||||
|
||||
- **규칙이 없었던 게 아니라 절반만 있었다**
|
||||
이 기준의 근거 사건이다.
|
||||
@@ -28,11 +28,11 @@ source:
|
||||
- **홈의 비교 구역이 세 번 바뀌었다**
|
||||
폭마다 측정을 남긴 기록이다.
|
||||
|
||||
## 목적
|
||||
## 프록시 지표만 보고 화면 동작을 판단하지 않는다
|
||||
|
||||
화면이 잘못됐다는 보고를 확인할 때 엉뚱한 값을 재고 「정상」이라 답하는 것을 막는다.
|
||||
|
||||
## 규칙
|
||||
## 최종 사용자 결과와 가장 가까운 지점을 직접 측정한다
|
||||
|
||||
### 1. 보고된 증상과 같은 축의 값을 잰다
|
||||
|
||||
@@ -52,19 +52,19 @@ source:
|
||||
|
||||
축소되어 글자 크기가 실제와 달라진다. 1425x4466 이 638x2000 으로 들어오면 17px 글자가 7~8px 이 되고, 그 그림에서는 크기 문제를 볼 수 없다. 화면 높이만큼 잘라 찍는다.
|
||||
|
||||
## 적용 조건
|
||||
## 중간 계층의 성공 여부로 UI나 API 결과를 추정할 때
|
||||
|
||||
- 화면이 잘못됐다는 보고를 확인할 때
|
||||
- 배포본의 실제 렌더 결과를 판단 근거로 삼을 때
|
||||
- 고쳤다고 답하기 전에 무엇을 쟀는지 대야 할 때
|
||||
- 여러 폭에서 배치가 갈리는 사이트를 검토할 때
|
||||
|
||||
## 예외
|
||||
## 프록시 지표 자체가 검증 대상인 경우
|
||||
|
||||
- 측정 대상이 좌표나 간격 자체라면 바운딩 박스는 프록시가 아니라 대상이다.
|
||||
- CSS 선언이 정본과 같은지를 보는 검사는 렌더 결과를 재지 않는다. 그 검사가 덮는 범위를 알고 쓰면 된다.
|
||||
|
||||
## 예시
|
||||
## healthy container와 실제 SPA 403 비교
|
||||
|
||||
- 격자와 열만 재고 「정상」이라 답했다. 사용자가 다시 지적한 뒤 전체 페이지 스크린샷을 찍어서야 26px 과 400 을 봤다
|
||||
- 목록 간격을 바운딩 박스로만 재서 엉뚱한 구역을 결함으로 지목한 적이 있다
|
||||
|
||||
+6
-6
@@ -16,7 +16,7 @@ source:
|
||||
|
||||
구역 클래스 아래에 태그 선택자로 배치를 걸면 그 구역 안의 모든 같은 태그가 걸린다. 제목 안의 링크가 행용 격자에 갇혀 h2 높이가 199px 이 됐다. 배치를 거는 규칙은 그 배치를 쓰는 요소까지 좁혀 적는다.
|
||||
|
||||
## 관계
|
||||
## CSS layout rule은 적용 범위를 넓히면 의도하지 않은 요소까지 잡는다
|
||||
|
||||
- **구역 전체에 건 격자가 제목까지 잡아 h2 높이가 199px 이 됐다**
|
||||
이 기준의 근거 사건이다.
|
||||
@@ -25,13 +25,13 @@ source:
|
||||
- **규칙이 없었던 게 아니라 절반만 있었다**
|
||||
같은 화면에서 난 다른 부류의 CSS 결함이다.
|
||||
|
||||
## 목적
|
||||
## 배치 규칙을 실제 배치를 쓰는 요소에만 적용한다
|
||||
|
||||
「디자인이 안 된 것처럼 보인다」는 보고의 원인이 되는 선택자 누출을 막는다.
|
||||
|
||||
이 부류는 규칙 자체는 맞고 걸리는 대상이 넓다. 그래서 규칙을 읽어서는 틀린 것을 찾을 수 없고, 그려진 결과를 봐야 한다.
|
||||
|
||||
## 규칙
|
||||
## selector 범위를 layout container까지 좁힌다
|
||||
|
||||
### 1. 배치 속성은 그 배치를 쓰는 요소까지 좁혀 적는다
|
||||
|
||||
@@ -51,19 +51,19 @@ display: grid|flex·grid-template-columns·padding 을 구역 클래스 아래
|
||||
|
||||
module 은 클래스 이름을 빌드 때 바꿔 전역 선택자와 겹치지 않게 만든다. 그래서 전역 규칙을 고쳐도 module 을 쓰는 화면에는 닿지 않고, 한 화면 안에서 두 언어가 섞이면 더 눈에 띈다.
|
||||
|
||||
## 적용 조건
|
||||
## grid와 flex 규칙을 section 단위로 추가할 때
|
||||
|
||||
- 구역 클래스 아래에 태그 선택자로 배치를 거는 CSS 를 쓸 때
|
||||
- 같은 구역 안에 제목과 목록이 함께 있을 때
|
||||
- 전역 규칙과 CSS module 이 한 화면에 섞여 있을 때
|
||||
- 「디자인이 안 된 것처럼 보인다」는 보고를 받았을 때
|
||||
|
||||
## 예외
|
||||
## 전체 section이 동일한 layout을 공유하는 경우
|
||||
|
||||
- 색이나 글꼴만 거는 규칙은 새어도 티가 나지 않으므로 대상이 아니다. 검사에 넣으면 결과가 늘 빨갛다.
|
||||
- 구역 안의 모든 같은 태그가 실제로 같은 배치를 써야 하는 화면이라면 좁히지 않아도 된다. 그때는 그 의도를 검사의 예외 목록에 적는다.
|
||||
|
||||
## 예시
|
||||
## home comparison h2가 grid item이 된 문제
|
||||
|
||||
- 비교 행을 위한 격자가 제목 안의 링크까지 잡아 제목이 200px 칸에 갇히고 h2 높이가 199px 이 됐다
|
||||
- 같은 모양이 다른 구역 아홉 곳에도 있어 선택자 51개를 고쳤다
|
||||
|
||||
Reference in New Issue
Block a user