← Notes
DEVELOP2026년 7월 29일

React 문서를 실제 사용 기준으로 바꾸기

구현 화면에서 확인할 수 있는 원칙을 중심으로, Root의 React 읽기 흐름을 구성했습니다.

Paiptree Creative Team

문서의 출발점을 바꿨습니다

React 문서는 라이브러리 목록이나 원칙의 나열보다, 화면을 만드는 사람이 다음 행동을 결정할 수 있어야 합니다. 그래서 Root의 Develop은 ReactFlutter을 최상위 선택지로 두고 각 기술의 실사용 장면부터 보여주기로 했습니다.

한 문서에서 확인해야 할 것

각 문서는 아래 순서를 유지합니다.

  1. 어떤 화면이나 기능에서 사용하는가
  2. 어떤 컴포넌트와 상태가 필요한가
  3. 구현할 때 지켜야 할 접근성과 반응형 기준은 무엇인가
  4. 관련된 코드와 다음 참고 지점은 어디인가

문서와 제품 화면의 거리

실제 화면과 동떨어진 문서는 빠르게 낡습니다. Root에서는 가능한 한 현재 공개 컴포넌트와 화면을 직접 가리키고, 기술 문서는 그 화면을 읽는 방법을 설명합니다.

이 방식은 문서를 별도 제품으로 과하게 키우지 않으면서도, React에서 무엇을 재사용하고 무엇을 새로 판단해야 하는지를 분명하게 만듭니다.

문서는 구현보다 앞서기보다, 구현을 다시 만들 수 있는 충분한 기준이어야 합니다.

전체 보기