원문: https://polkadot.com/blog/polkadot-dev-docs-hub
저자: Alberto Viera(PaperMoon 창립자)
편집자: OneBlock+
Decentralized Futures의 자금 지원을 받아 PaperMoon 팀은 공식적으로 Polkadot 개발자 문서 센터를 시작했습니다. 이 통합 플랫폼은 개발자의 진입 과정을 단순화할 뿐만 아니라 포괄적인 개발 리소스와 기술 문서를 제공하여 Polkadot 생태계 개발에 중요한 이정표를 세웁니다. 다음으로 OneBlock+에서는 개발자 문서 센터의 탄생 과정, 구조 설계 및 향후 확장 계획을 자세히 소개합니다.
협업적 혁신: Polkadot 개발자 문서 센터 의 탄생
Polkadot 개발자 문서 센터는 Decentralized Futures 의 자금 지원을 받아 개발되었습니다. 이는 분권화 정신을 고수하고 다양한 분야의 협력을 다루는 획기적인 프로젝트입니다. 이는 서로 다른 팀이 공통 목표를 위해 어떻게 협력할 수 있는지 보여줄 뿐만 아니라 Polkadot, 생태계 및 커뮤니티에 실질적인 이점을 제공합니다. PaperMoon 은 프로젝트의 주요 발기인이자 코디네이터이며 Web3 Foundation(W3F)은 피드백, 콘텐츠 제작 및 마이그레이션, 법률 상담 측면에서 중요한 지원을 제공합니다. Distractive는 랜딩 페이지 디자인, 브랜드 안내, 정보 피드백 및 출판 과정 지원을 담당했습니다. 마지막으로 Parity는 개발 프로세스 및 일부 조정 작업 구현에도 참여합니다.
분열에서 통합으로: PaperMoon의 사명과 비전
PaperMoon 팀이 Decentralized Futures로부터 자금을 받은 후 PaperMoon 팀의 초기 목표는 Chopsticks 문서부터 Asset Hub와 상호 작용하는 방법에 이르기까지 Polkadot 생태계와 관련된 문서를 만드는 것이었습니다. 그러나 이러한 이정표를 발전시키기 위해 팀은 더 심각한 문제를 빨리 깨달았습니다. 즉 , Polkadot 개발자 문서의 조각난 상태가 개발자의 온보딩 경험에 심각한 영향을 미치고 있다는 것입니다.
개발자는 Polkadot 문서를 사용할 때 오랫동안 다음과 같은 문제에 직면해 왔습니다.
정보는 Substrate.io, Polkadot Wiki, GitHub 및 포럼을 포함한 여러 플랫폼에 분산되어 있습니다 .
많은 문서 내용이 오래되었거나 필요한 정보를 찾기가 어렵습니다.
개발자들은 종종 리소스의 불일치 로 인해 시작하기가 혼란스럽고 어렵다고 생각합니다.
다른 생태계에 비해 많은 문서가 기본 사이트와 동일한 도메인 이름으로 호스팅되며 Polkadot에서 개발하는 개발자는 쉽게 길을 잃거나 어디서부터 시작해야 할지, 정확한 정보를 찾는 방법을 모를 수 있습니다. 이러한 종류의 문서 조각화는 상당한 마찰을 일으킬 뿐만 아니라 개발자의 의욕을 꺾어 SEO 및 기타 측면에 부정적인 영향을 미칠 수도 있습니다.
Polkadot은 샤딩된 생태계이지만 이것이 해당 문서도 샤딩되어야 한다는 의미는 아닙니다. 이러한 인식으로 인해 PaperMoon 팀은 W3F 및 DF 위원회에 주요 변경 사항을 제안하게 되었습니다. 즉, 분산형 미래 작업에 다시 초점을 맞추고 대신 Polkadot 개발자 문서 센터를 만드는 것입니다. PaperMoon 팀의 비전은 명확합니다. 개발자가 Polkadot을 구축할 때 필요한 정보를 찾을 수 있는 통합 진입점으로 센터를 만드는 것입니다 . 데이터가 문서 센터에 직접 저장되거나 개발자가 외부 리소스(예: Polkadot-SDK Rust 문서)로 이동하는지 여부에 관계없이 개발자는 자신 있게 문서 센터로 이동하여 합리적인 안내와 도움을 통해 필요한 리소스를 쉽게 찾을 수 있습니다. 이야기.
적합한 콘텐츠 찾기: 정보 아키텍처
Polkadot 개발자 문서 센터의 콘텐츠 구조를 결정하기 위해 PaperMoon 팀은 두 차례의 독립적인 정보 아키텍처 연습을 수행했습니다. 콘텐츠가 단편화되어 있고 일부 정보가 오래되었기 때문에 첫 번째 연습에서는 참가자들에게 문서 센터에서 보고 싶은 주제나 페이지를 15개 이상 나열하도록 요청했습니다. 이 단계에서 PaperMoon 팀은 W3F, Parity, PaperMoon, Distractive, 파라체인 팀, 지갑 개발자 등 다양한 분야의 주요 생태계 플레이어 14명을 초대했습니다. 최종적으로 참가자들은 18개 카테고리를 포함하는 154개의 제안을 제출했습니다. 핵심 개발자 2명, 마케터 2명, 비즈니스 개발자 1명, 개발자 관계 직원 3명, 생태계 팀 직원 3명, 기술 교육 직원 2명, 제품 엔지니어링 직원 1명 등 참가자의 배경은 매우 다양합니다. 이러한 권장 사항을 종합함으로써 팀은 다양한 영역에서 어디에 집중해야 할지 더 명확하게 이해할 수 있습니다.
이러한 다양한 제안을 수집한 후 두 번째 연습에서는 참가자에게 제안을 다양한 모듈로 구성하고 이러한 모듈이 문서의 상위 수준 분류가 되어야 한다고 제안하도록 요청했습니다. 이번 연습 라운드에는 Polkadot 생태계에 대해 기술적으로 익숙하거나 매우 친숙한 총 9명의 참가자가 참여했습니다. 결과를 요약하면 최소 12개의 핵심 모듈이 식별되어 최종 정보 아키텍처의 기초가 형성되었습니다.
이 두 차례의 연습과 W3F 및 Parity와의 심층적인 상호 작용을 통해 PaperMoon 팀은 마침내 Polkadot 개발자 문서 센터의 최종 정보 아키텍처 설계를 완성했습니다. 이제 문서 센터에서 이 버전을 볼 수 있습니다. 이 버전에서 개발자는 네 가지 주요 범주로 나뉩니다.
블록체인 개발자: Polkadot SDK를 기반으로 블록체인을 구축하고 이를 Polkadot에서 출시하려는 개발자입니다. 그들은 Polkadot의 기본 개념을 이해하고, Polkadot의 보안을 활용하도록 체인을 구성하고, 다양한 테스트 프레임워크에 액세스하고, 런타임 업그레이드를 이해하는 등의 작업을 수행해야 합니다.
스마트 계약 개발자: Polkadot 생태계에서 스마트 계약 기반 애플리케이션을 구축하려는 개발자. 다양한 경로 옵션(예: EVM 또는 Wasm), 사용 가능한 도구 및 사용할 수 있는 체인(예: AssetHub, Acala, Astar, Moonbeam 등)을 이해해야 합니다.
인프라 제공자: Polkadot 위에서 인프라(예: 검증자, RPC 제공자)를 실행하려는 개발자. RPC 또는 검증인 노드를 올바르게 설정하는 방법을 알아야 하고 검증인이 된다는 것이 무엇을 의미하는지 이해해야 합니다.
도구 개발자: Polkadot 생태계를 위한 공통 도구(예: SDK, 모니터링 대시보드, 웹 사이트 등)를 구축하려는 개발자입니다. 다양한 프로그래밍 언어로 제공되는 도구를 이해해야 합니다.
현재의 예비 버전은 단지 시작점일 뿐입니다. 다음으로 PaperMoon 팀은 광범위한 개발자 커뮤니티와 소통하여 피드백을 수집하고 각 대상의 구체적인 요구 사항을 더 깊이 이해할 것입니다. 충분한 관심과 시간을 받은 후에야 우리는 개발자 카테고리를 더욱 세분화하고 다양한 요구 사항을 가진 개발자에게 보다 정확한 리소스를 제공할 수 있습니다.
콘텐츠 마이그레이션 및 생성: 기존 리소스에서 새로운 플랫폼으로 전환
Polkadot 개발자 문서 센터의 전체 구조가 완성된 후 PaperMoon 팀은 콘텐츠 제작 작업을 시작했는데 이는 어려운 작업이었습니다! 팀은 먼저 Substrate.io 또는 Polkadot Wiki에서 마이그레이션할 수 있는 콘텐츠와 처음부터 새로 만들어야 하는 콘텐츠를 분류했습니다.
필요한 콘텐츠를 마이그레이션하고 생성하는 작업은 매우 집중적인 프로세스입니다 . 문서의 무결성을 보장하기 위해 PaperMoon 팀은 약 50페이지의 콘텐츠를 업데이트하고 새 문서 센터로 마이그레이션하기로 결정했습니다. 즉, 초기 버전에는 80페이지 이상의 콘텐츠가 포함됩니다. 또한 개발자가 필요한 항목을 보다 쉽게 탐색하고 찾을 수 있도록 색인 페이지를 만들어야 합니다.
전체 프로세스 동안 PaperMoon 팀은 총 170개의 풀 요청(PR)을 생성했습니다 . 각 PR은 기술적 정확성을 보장하기 위해 W3F 기술 교육자의 지원을 받는 PaperMoon 엔지니어로 주로 구성된 전담 콘텐츠 검토 팀에 의해 검토됩니다. 동시에 내용이 문서 표준을 충족하는지 확인하는 형식 검토 팀(PaperMoon 엔지니어로 구성)도 있습니다. 이 과정은 약 3개월 동안 진행되었으며 자금 조달을 통한 기타 작업도 포함되었습니다.
한편 PaperMoon 팀은 Distractive와 협력하여 문서 출시 프로세스, 랜딩 페이지, 법률 및 브랜드 안내를 처리하여 최종 출시가 원활하게 진행되도록 했습니다.
모든 준비가 완료된 후 PaperMoon 팀은 피드백을 제공하기 위해 W3F 및 Parity 팀을 위한 Polkadot 개발자 문서 센터의 내부 초안을 작성했습니다. 그들은 콘텐츠, 내러티브 구조, 제품 방향에 대해 매우 귀중한 제안을 했습니다.
이제 PaperMoon 팀은 Polkadot 개발자 문서 센터의 첫 번째 버전을 출시할 준비가 되었습니다.
다음 단계: 새로운 여정의 시작
Polkadot 개발자 문서 센터의 첫 번째 버전이 출시되면서 PaperMoon 팀의 작업은 사실상 끝나지 않았습니다. 이것은 새로운 여정의 시작입니다.
출시 후 PaperMoon 팀은 다음과 같은 주요 작업(기타 관련 문제 중에서)을 발전시키는 데 중점을 둘 것입니다.
코드 조각 저장소 구조 만들기 : 문서에 표시된 모든 코드 예제가 제대로 작동하는지 확인하기 위해 모든 코드 조각을 저장하고 테스트하는 시스템을 구축합니다.
최소 문서 표준 설정 : GitHub 리포지토리에서 최소 문서 표준 세트를 추출하고 생성하여 콘텐츠가 각 릴리스마다 중복 및 업데이트되지 않도록 합니다. 동시에 PaperMoon 팀은 문서화된 도구에 코드를 제공하여 이러한 표준을 준수하도록 할 계획입니다.
GitHub 러너 최적화 : GitHub 러너를 최적화하여 문서화 중인 제품의 새 버전 릴리스를 추적하여 문서 콘텐츠가 항상 최신 상태인지 확인합니다.
확장된 튜토리얼 콘텐츠 : PaperMoon 팀은 개발자가 Polkadot 생태계를 더 잘 이해하고 적용할 수 있도록 더 많은 주제에 대한 튜토리얼을 추가하고 보다 실용적인 개발 사례를 제공할 것입니다.
또한 2025년 Polkadot의 계획이 점차 전개됨에 따라 PaperMoon 팀은 개발자가 Polkadot에서 프로젝트를 성공적으로 구축할 수 있도록 문서화 측면에서 보다 완벽한 지원을 제공할 예정입니다. 특히, 이더리움 호환 스마트 계약이 도입됨에 따라 PaperMoon 팀은 W3F 및 Parity와 협력하여 Polkadot의 새로운 스마트 계약 내러티브를 홍보하여 개발자가 스마트 계약 기반 애플리케이션을 원활하게 구축하는 데 도움이 되는 정확한 문서를 제공받을 수 있도록 할 것입니다.
결론: 지속적인 최적화 와 커뮤니티 공동 구축
Polkadot 개발자 문서 센터는 Polkadot 생태계에서 중요한 이정표이며, 개발자가 필요로 하는 모든 리소스를 하나의 플랫폼에 모아서 Polkadot에서 더욱 편리하게 구축하고 개발할 수 있도록 해줍니다 . 그러나 이것은 단지 시작점일 뿐입니다. 통합 문서 센터는 지속적으로 업데이트되고 생태계와 동기화되는 경우에만 진정한 가치를 얻을 수 있습니다.
Polkadot에서 도구나 프로젝트를 구축하는 경우 PaperMoon 팀은 문서 센터에 기여하여 팀이 지속적으로 개선할 수 있도록 진심으로 초대합니다 . 새로운 콘텐츠를 추가하든, 기존 정보를 업데이트하든, 혁신적인 아이디어를 제안하든 모든 기여는 가치가 있습니다.
이는 커뮤니티에 의해, 커뮤니티를 위해 운영되는 최고의 오픈 소스입니다. Polkadot 개발자 문서 센터를 개발자가 혁신적인 프로젝트를 만들 수 있는 첫 번째 선택 리소스로 만들기 위해 함께 노력합시다.
👉 Polkadot 개발자 문서 센터 방문: https://docs.polkadot.com/
