디자인이나 아키텍처에 대한 문서가없는 오픈 소스 프로젝트는 어떻게 성공할 수 있습니까?

유명한 오픈 소스 프로젝트를 연구하여 프로그래밍 기술을 향상시키고 싶지만 소스 코드를 뛰어 넘어 쉽게 길을 잃을 수 있습니다.

따라서 코드 구성에 대한 일반적인 아이디어를 얻기 위해 UML 다이어그램과 같은 설계 또는 아키텍처에 대한 설명서를 읽기로 결정했습니다. 그러나 놀랍게도 Hibernate, Spring, ASP.NET MVC, Rails 등과 같은 대규모 오픈 소스 프로젝트에 대한 아키텍처 문서를 찾을 수 없습니다.

그래서 궁금해지기 시작했습니다. 새로운 개발자가 읽을 아키텍처 / 디자인 문서가 없거나 프로젝트 관리자가 소스 코드를 열었지만 문서를 닫은 경우 어떻게 오픈 소스 프로젝트가 성공할 수 있습니까?

새로운 개발자가 읽을 아키텍처 / 디자인 문서가 없다면 오픈 소스 프로젝트가 성공할 수있는 이유는 무엇입니까?

당신이하고있는 일을 알고 있고, 당신이보고있는 것 (및 기대하는 것)에 대해 합리적으로 친밀한 이해를 가지고 있다고 가정합니다.

예를 들어 Symfony 프레임 워크의 PHP 코드를 살펴보면 종속성 주입, 이벤트, 모델 / 뷰 / 컨트롤러 패턴 등에 대해 이미 알고있을 것입니다.

마찬가지로, 리눅스 커널의 C 코드로 뛰어들었다면, 모듈성, 신호, 프로세스, 스레드 등에서 실제로 경쟁력이 있다고 가정합니다. 또한 하루 종일 16 진수를 먹고 거대한 삽으로 코어 덤프를 발굴 할 수 있습니다.

관리자는 사실상 문서이기 때문에 아키텍처를 문서화하는 데 어려움을 겪지 않을 것입니다. 간혹 소스 트리에서 어디에 있는지에 대한 개요를 찾을 수 있습니다. 보다 일반적으로 소스 트리가 구성되는 방식은 설명이 필요하지 않습니다.

요컨대, 코드를 들여다 볼 때까지 관리자가 알 것으로 기대하는 기술이 부족하면 급여 등급보다 훨씬 높은 것을 파고들 것입니다. 먼저 개념을 숙지하십시오. MVC 모델이란 무엇입니까? 의존성 주입이란 무엇입니까? 기타 다이빙

가장 성공적인 오픈 소스 프로젝트는 무엇보다도 성공을 거두었습니다. 무엇보다도이 프로그램은 인상적 이었거나 당시에는 다른 프로그램으로는 할 수 없었던 일이었습니다. 프로젝트를 시작한 프로그래머가 코드를 잘 알지 못하기 때문에 소스가 잘 문서화되어있는 것은 아닙니다. 오픈 소스 프로젝트가 문서화 될 필요가 없다는 것은 불행한 현실입니다. 좋은 프로그램이거나 평범한 프로그램이어야하지만 프로그래머가 관심을 갖도록 잘 문서화되어 있어야합니다.

오픈 소스 개발자는 일반적으로 재능이 있고 전문 분야에서 프로젝트를 선택하기 때문에 이미 두개골 안에 "문서"가 있습니다. 과장이 거의없이 다음 중 하나라도 부족한 경우에만 철저한 문서가 필요합니다.

솔직히 말해서, 알 수없는 코드베이스에 직면 할 때 실제로 "문서"를 읽지 않습니다. 간단한 소개, 몇 가지 개념적인 스케치와 코드로 직접! 실험, 작은 변화를 시도하십시오. 잘 설계된 코드에 완벽하게 작동합니다. 내가 끔찍한 혼란에 직면하면 그것들을 배우는 가장 좋은 방법은 비트 단위로 리팩터링하여 선명도를 향상시키는 것입니다 (이상적으로 단위 테스트의 도움으로).

추가적인 이유는이 프로젝트의 일반적인 유기적 디자인 루트 일 수 있습니다. 그러면 아키텍처는 "문서화 된"엔터티보다 개발자의 생각에서 진화 된 비전입니다.

이러한 문서가 종종 존재하지 않는 이유는 매우 간단합니다. 프로그래머는 문서를 작성하지 않고 프로그래밍을 좋아합니다. 특히 개발자가 자유 / 레저 시간 동안 종종 기여하는 오픈 소스 프로젝트의 경우.

기본적으로 문서 작성은 재미 있지 않습니다. 그리고 그들이 돈을받지 못하면 누가 자유 시간을 재미없는 일을하고 싶습니까?