프로젝트를 오픈 소스로 만들 때 고려해야 할 사항은 무엇입니까?

Question

나는 오픈 소스로 프로젝트를 게시 막 해요, 그리고 것 정말 몇 가지에 대한 몇 가지 의견을 같이 :

1. 코드는 매우 깨끗하지만, 버전 관리 역사는 아니다. 실수, 디버그 코드, 부적절한 코드 등. 게시하기 전에 내역을 지우거나 어쨌든 공용 저장소로 가져와야합니까?

2. 튜토리얼, 기능 설명 또는 API 문서를 우선적으로 작성해야합니까?

3. 사람들이 쉽게 새로운 프로젝트를 시작할 수 있도록하는 다른 생각은 무엇입니까? 내 아주 겸손 의견으로

Answer 1

:

1) 당신이가는 오픈 소스에 설정하는 경우, 코드의 자랑. 우리는 실수와 버그가 있다는 것을 알고 있습니다. 더 많이 나올 것이기 때문에 공개적으로 표시 할 수없는 것처럼 느끼지 마십시오. 할 수있어!

2) 확실히. 아마 그것도 주문하십시오. 왜냐하면 그것이 제품을 사용하는 사람들이 읽는 순서이기 때문입니다. 그들은 소프트웨어를 사용하기 전에 소프트웨어를 사용해야합니다.

3) 내가 할 수있는 최선의 조언은 사람들이 환경을 구성하는 데 도움이되는 스크립트를 사용하여 빌드 지침을 명확하게 작성하는 것입니다. 오픈 소스 소프트웨어에 대한 공통적 인 전염병은 새 개발자가 수많은 라이브러리를 다운로드하고 이 올바르게 작동하도록 상자를 구성해야한다는 것입니다. 바로 소프트웨어를 빌드하려면입니다. 그것은 나에게 매우 실망스럽고 매우 빨리 내게 할 수있다.

행운을 빈다.

Answer 2

1. 배포권이없는 저작권 보호 코드를 사용하지 않았거나 재배포, 신용 등의 문제가있는 경우를 제외하고는 전적으로 귀하가 선택한 것입니다.

2. 무엇인지 모른다고하기가 어렵습니다. 그것을 사용하기 위해 당신이 필요로하는 것은 무엇입니까? 먼저 무엇을보고 싶습니까? (아마도 튜토리얼 ...)

3. 아마도 설치를 포함한 시작부터 끝까지의 예입니다. 아마도 가상 환경이나 새로운 OS 설치를 실행하는 데 어려움을 겪을 수 있으므로 설치 지침에서 모든 사항을 다루어야합니다.

Answer 3

1. 몇 가지가 함께 커밋 스쿼시 정도로 쉬워야하고, 노력은 가치가있을 것입니다. 개발자는 역사를 살펴보고 프로젝트가 어떻게 설계되었는지에 대한 통찰력을 얻습니다.
2. 확실히. 최소한 Doxygen과 같은 문서 엔진을 사용하여 문서를 생성하십시오. 자습서는 현재로서는 불필요합니다. 커뮤니티는 코드가 잘 작성 되었다면 자습서를 작성합니다.
3. 항상 좋은 포장재가 도움이됩니다. 둘 이상의 아키텍처에 대해 미리 컴파일 된 바이너리를 생성하고 가능한 경우 RPM 및 DEB를 만듭니다. 이렇게하면 진입 장벽이 크게 낮아집니다. 아무도 사용하지 않는 소프트웨어에 기여하지 않습니다. 또한 Bugzilla와 같은 멋진 버그 추적기를 사용하거나 Launchpad 또는 Trac과 같은 통합 솔루션을 사용할 수도 있습니다. 또한 메일 링리스트와 IRC 채널을 설정하십시오. 이것은 커뮤니티를 구축하는 데 도움이됩니다.