Skip to content

docs: 문서 규칙 중복 제거 및 Markdown 가독성 기준 정리#66

Merged
oneplast merged 2 commits intodevfrom
docs/##_문서_규칙_중복_제거_가독성_향상
Apr 7, 2026

Hidden character warning

The head ref may contain hidden characters: "docs/##_\ubb38\uc11c_\uaddc\uce59_\uc911\ubcf5_\uc81c\uac70_\uac00\ub3c5\uc131_\ud5a5\uc0c1"
Merged

docs: 문서 규칙 중복 제거 및 Markdown 가독성 기준 정리#66
oneplast merged 2 commits intodevfrom
docs/##_문서_규칙_중복_제거_가독성_향상

Conversation

@oneplast
Copy link
Copy Markdown
Collaborator

@oneplast oneplast commented Apr 7, 2026

📝 Part (해당되는 것만 체크)

  • BE
  • FE
  • Infra
  • Docs
  • Test

#️⃣ 연관된 이슈

No response


🔎 작업 내용

1. 주요 변경 사항 요약

  • 문서 작업 시 docs/README.md 와 작업 경로까지 내려가는 동안 추가로 마주치는 디렉토리 README.md 를 순서대로 확인하도록 기준 정리
  • 상위 문서에 이미 명시된 전역 규칙은 하위 README.md 및 템플릿에 반복되지 않도록 중복 문구 제거
  • Markdown 가독성 규칙 추가 및 discussions 템플릿 정리

2. 상세 내용 (선택)

1. 문서 작업 진입 규칙을 정리하였습니다.

  • AGENTS.md 에 다음 기준을 반영하였습니다.
    • 문서 작업 시 docs/README.md 를 먼저 확인
    • 대상 경로까지 내려가는 동안 추가로 마주치는 디렉토리 README.md 를 순서대로 확인하도록 기준 반영

2. 전역 규칙과 하위 문서의 중복을 제거하였습니다.

  • 상위 위치에 존재하는 규칙을 하위 README.md 나 템플릿에 다시 복제하지 않도록 규칙을 추가하였습니다.

3. Markdown 가독성 기준을 전역 문서 규칙으로 추가하였습니다.

  • docs/README.md 에 헤더 깊이, 리스트 형식, 문단 길이, 강조 사용, 구분선 사용에 대한 기준을 추가하여 가독성을 향상시키도록 하였습니다.
  • discussions 템플릿과 관련 문서도 이 기준에 맞춰 정리하였습니다.

3. 프롬프트 경로

4. 참조 문서 경로 (ADR, discussions, roadMap ...)


💬 집중 리뷰 요청

  • 변경된 규칙들을 가볍게 한 번 확인해주시기 바랍니다.

🧪 테스트 방법

1. 로컬 실행 방법

No response

2. 테스트 시나리오

No response


✅ PR 체크리스트

  • 불필요한 디버그 로그 / 주석 제거
  • breaking change 여부 확인 및 문서화
  • 신규/변경된 기능에 대한 테스트 코드 추가 또는 기존 테스트 통과
  • 로컬에서 주요 시나리오 수동 테스트 완료
  • 관련 문서(노션, README, API 문서 등) 업데이트

📈 이미지 / 캡처 (필요 시)

No response

oneplast added 2 commits April 7, 2026 13:09
1. 문서 가독성을 위한 Markdown 가독성 규칙을 추가하였습니다.
2. 기존 방식에서 중복 제거가 제대로 이루어지지 않아, 조금 더 구체적으로 중복 제거와 관련된 전/후처리 규칙을 명시했습니다.
3. 문서화 시 AGENTS -> 상위 README -> 하위 README 흐름으로 참조하도록 가이드에 명시하였습니다.
4. 기존 Markdown 파일들에 남아있는 중복 포인트들을 더 제거하였습니다.
@oneplast oneplast requested review from hellonaeunkim and jho951 April 7, 2026 05:22
@oneplast oneplast self-assigned this Apr 7, 2026
@oneplast oneplast added the documentation Improvements or additions to documentation label Apr 7, 2026
@oneplast oneplast merged commit 0be43ac into dev Apr 7, 2026
1 check passed
@github-project-automation github-project-automation bot moved this from Todo to Done in Block-server Apr 7, 2026
@oneplast oneplast deleted the docs/##_문서_규칙_중복_제거_가독성_향상 branch April 7, 2026 05:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant