Skip to content

Commit 57e22d4

Browse files
committed
docs: 필요한 정보만 남기기 세부 내용 추가
1 parent dac2fba commit 57e22d4

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

docs/sentence/compactness.mdx

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,16 @@ import { DoDont } from '@/components/DoDont/DoDont';
6363
</DoDont.Do>
6464
</DoDont>
6565

66+
### ✅ 괄호 사용을 줄이세요
67+
68+
괄호를 사용하면 독자가 헷갈릴 수 있는 정보를 부연 설명할 수 있어요. 문서를 작성할 때 대표적으로 다음과 같은 상황에서 괄호를 사용해요.
69+
70+
- 앞말을 보충하는 내용을 덧붙일 때: 여러 클라이언트(모바일 앱, 웹 브라우저)에서 동시에 요청을 보낼 수 있습니다.
71+
- 고유어나 약어를 풀어쓸 때: 데이터베이스 연결은 JDBC(Java Database Connectivity) 드라이버를 통해 설정할 수 있습니다.
72+
- 외래어의 원어를 나타낼 때: 큐(Queue)는 데이터를 FIFO(First In First Out) 방식으로 처리하는 자료구조입니다.
73+
74+
하지만 괄호를 여러 번 사용하거나 괄호 속에 너무 긴 정보가 들어가면 문장의 흐름이 끊겨요. 괄호를 사용하기 전에 이 내용이 정보를 부연 설명하기 위해 꼭 내용인지 판단하세요. 만약 문장의 흐름을 끊을 정도로 긴 정보를 담아야 할 때는 괄호를 사용하지 말고, 별개의 문장으로 나누는 것이 좋습니다.
75+
6676
## 실습 문제
6777

6878
아래 문장을 더 간결하고 명확한 문장으로 수정해보세요. 문제를 풀었다면 답안을 확인해서 비교해 보세요.
@@ -86,3 +96,13 @@ import { DoDont } from '@/components/DoDont/DoDont';
8696
설정 파일을 변경한 후 저장하세요. 그런 다음, 변경 사항이 적용되었는지 확인하고 필요하면 서버를 다시 시작하세요.
8797

8898
:::
99+
100+
**3. 괄호를 사용하지 않고 문장을 작성해 보세요.**
101+
102+
> 시스템은 자동으로 로그를 저장합니다(서버가 재시작될 때도 유지)
103+
104+
::: details 정답 확인
105+
106+
시스템은 서버가 재시작되어도 자동으로 로그를 유지합니다
107+
108+
:::

0 commit comments

Comments
 (0)