2009-11-10 5 views
1

프로젝트가 제대로 문서화되지 않은 경우 오픈 소스 프로젝트를 배울 수있는 방법은 무엇입니까?잘 설명되어 있지 않은 오픈 소스 프레임 워크를 어떻게 배울 수 있습니까?

소스 코드를 읽으시겠습니까?

+0

소스가있는 경우 문서가 필요합니다. 모든 문서가 모두 출처에 관한 것입니다. –

+0

그러나 문서는 사용자가 프레임 워크를 쉽게 이해할 수 있도록 도와줍니다. – Benny

+0

문서가 정확한지 여부는 소스를 이해하는 데 유용합니다. 잘못된 문서는 전혀없는 것보다 훨씬 쉽게 악화 될 수 있으며 문서는 매우 쉽게 활성 프로젝트에서 잘못 될 수 있습니다. 프로젝트에서 작업하고 싶다면 소스를 이해해야하므로 목표가되어야합니다. –

답변

3

나는이 말을 싫어하지만 이것은 종종 비즈니스 환경에서도 그렇습니다. 특정 프로젝트가 정말 마음에 들면, 파고 들어가서 배우기 만하면됩니다. 필자가 문서화되지 않은 라이브러리로 시작한 한 가지 방법은 먼저 Visual Studio에서 클래스 다이어그램을 만드는 것입니다. 개발자가 명명 규칙을 신중하게 고려하면 클래스가 문서화되기 때문에 상호 작용을 볼 수 있습니다. 그렇지 않으면, 정말 그걸 가지고 노는 것에 있습니다.

점프하고 소스 헤드를 다루려고 시도하는 것이 아니라 모두 한 번에 작업 할 수있는 것이 좋습니다. 예를 들어, 버그/기능 목록을 살펴보십시오. 간단한 것을 시작하고 길을 나아가십시오. 시간이지나면서 코드 기반에 대해 더 많이 알게 될 것입니다.

필자는 문서 작성을 피하는 것을 권장하지 않지만 모든 개발자가 문서화되지 않은 코드 작업에 익숙해 져야한다고 제안합니다.

2

출처 Luke를 읽으십시오.

진지하게, 나는 다른 방법이 없습니다. 더하기 : 나를 위해 학습은 재미있는 부분입니다 ...

+0

그리고 테스트를 시작하십시오. 그들은 많이 말할 수 있습니다. –

0

때로는 opensource 프레임 워크에 대한 설명서가 무료가 아닙니다. 너는 그것을 사야한다. 어쩌면, 그것은 당신의 경우입니까?

+1

심각하게? 모범이 있습니까? – Lazarus

+0

다양한 오픈 소스 프로그램을 사용하여 구입할 수있는 제 3 자 서적이 많이 있으며 유용 할 수 있습니다. 일반적으로 시스템을 이해할 수 있도록 설계된 것은 아닙니다 (Linux 커널을 이해하는 데 필요한 O'Reilly 서적을 가지고 있지만). 또한 오픈 소스 프로젝트의 문서는 종종 부족합니다. 그 외에는 예제가 없습니다. –

+0

예 (예 : JasperReports). – Yurish

0

사용할 수있는 포럼 또는 커뮤니티가있는 경우 먼저 질문해야합니다.

0

설명서/예제가 거의 없거나 없으면 소스 코드를 읽는 것이 유일한 방법입니다.

프레임 워크의 기본 개념 (예 : MVC 패턴)을 처음 사용하는 사람이라면 더 나은 문서를 찾아 볼 것을 권장합니다. 코드를 이해하는 것뿐만 아니라 하고있는 것뿐만 아니라 그것을하고있는 이유.

당신이 언어에 익숙하다면 그 언어로 작업 할 가치가 있습니다. 당신이 프레임 워크를 작동시킬 수 있다면, 적어도 그것에 대한 블로그에서, 당신의 위치에있는 다른 사람들은 도움을 얻을 수 있습니다. 또한 문서를 작성하여 프로젝트에 기여할 수도 있습니다 ....

2

사용자에게주의를 환기시키는 다른 프레임 워크를 찾아보십시오.

0

설명서가 좋지 않거나 없으면 프레임 워크를 배우지 않습니다. 내가 생각하기에 효과가있을 수도 작동하지 않을 수도있는 것에 대해 작업 할 필요가 없습니다. 그런 식으로 내 일을하는 것은 모래 위에 짓는 것을 의미합니다.

+0

아이러니하게도, 모래는 실제로 건물을위한 정말로 좋은 기반입니다. 내 말은, 두바이를 봐. :) – nickf

+0

earth-quake safe? – Benny

4

통찰력 프로젝트에서 사용하고있는 컨트롤에 대해 직면하고 있습니다.

내가하는 일은 다음과 같습니다.

  1. 사용 가능한 경우 소스 코드를 읽으십시오.

  2. 소스 코드를 사용할 수없는 경우 Reflector를 사용하여 소스 코드를 얻고 읽습니다.

  3. 커뮤니티가있는 경우 알아 두십시오. 포럼 그룹이 있다면 가입하십시오. 질문을 게시하고 지식이 무엇이든 공유하고 적극적으로 참여하십시오. 도움을 주면 다른 사용자가 도움을 줄 수 있습니다.

그게 전부입니다. 그 중 어느 것도 당신을 위해 일하지 않는다면, 나는 그 옵션을 사용할 수 있다면 대안을 찾길 강력히 권합니다.

1

Chrys가 게시 한 링크에서 언급했듯이 소스 코드 문서 도구를 사용하여 문서를 만들 수 있습니다. Doxygen 또는 프레임 워크의 소스 코드와 비슷한 것을 실행하고 문서화되지 않은 함수 나 클래스 등을 제외하지 않도록 설정할 수 있습니다. 정말 마음에 들면 인라인 함수 소스 코드로 가져 와서 상속, 포함, 공동 작업, 호출자, callee 및 템플릿 인스턴스화 다이어그램을 사용하면 전체 시스템의 내부에 대한 포괄적 인 개요를 얻게됩니다.

또한 제대로 문서화되지 않은 프로젝트의 일부는 공동체를 통해 뭔가를 얻으 려하지만 뒤죽박죽 된 커뮤니티가 있습니다. 함께 메일 링리스트에 가입하고 질문 할 수 있습니다.

그렇지 않으면 많은 시행 착오를 준비해야합니다.

0

다음 빈약 한 영혼이 고생 할 필요가 없도록 조사하여 문서화하고 프로젝트에 다시 첨부하십시오.

한편, 문서화되지 않은 프레임 워크로 왜 어려움을 겪고 있는지 물어보십시오. 그것이 문서화되지 않았다면 분명히 그것을 사용하는 것의 이점은 지나치게 묘사되었거나 잘 설명되어 있지 않습니다.

+0

사용자가 원하는 것과 함께 이점을 문서화 할 수 있습니다. 이것은 코드에 대한 이해에 반드시 도움이되지는 않습니다. –

1

단위 테스트를 작성하여 새로운 코드를 작성하려는 사람들이 있습니다.

관련 문제