툴허브/해커톤 2022
위키미디어 해커톤 2022는 기술 프로젝트에서 함께 작업하고, 새로운 기술을 배우고, 다른 기술 기여자를 만날 수 있는 무료 이벤트입니다. 2022년 5월 20일부터 22일까지 온라인으로 개최됩니다.
툴허브는 위키미디어 운동에 사용되는 소프트웨어 도구의 커뮤니티 관리 카탈로그입니다. 기술 지원자는 툴허브를 사용하여 자신이 만들거나 유지 관리하는 도구를 문서화할 수 있습니다. 모든 위키미디어인들은 툴허브를 사용하여 작업 흐름에 도움이 되는 도구를 검색하고 다른 사람과 공유할 유용한 도구 목록을 만들 수 있습니다.
이 페이지는 해커톤이 열리는 주간에 추가 정보로 업데이트됩니다. 다시 체크인하십시오!
물론 작업 및 개선 사항에 대한 제안 사항이 있으면 여기에 추가하십시오.
참여 방법
참가 조건은 없습니다. 오랫동안 기술에 기여해 온 사람이든, 호기심 많은 신입이든, 그 사이에 있는 어떤 사람이든 모두 환영합니다. 위키미디어의 기술 공간 및 우호적인 분위기 정책에 대한 행동 강령을 따르도록 요청합니다.
다음은 툴허브를 처음 사용하는 경우 유용한 리소스입니다:
- 사용 설명서
- 우리가 하는 일을 추적하는 파브리케이터 워크보드
- Gerrit 코드 저장소
- 기여 방법: 기술 기여자를 위한 빠른 시작 가이드
세션
해커톤 기간 동안 인프라 도구실에서 50분간 소개 세션이 진행됩니다. 세션은 두 가지 다른 시간에 열리며 시간대에 가장 적합한 시간을 선택할 수 있습니다:
이 세션에서는 툴허브 프로젝트에 대해 배우고 이를 사용하여 봇, 웹 서비스, 사용자 스크립트, 소도구, 복합 템플릿 및 루아 모듈에 대한 작업을 다른 위키미디어인에게 공개하는 방법을 배울 수 있습니다.
도구 허브 기록 편집
도구정보 기록은 툴허브의 핵심입니다. 여기에는 특정 도구에 대한 사용 가능한 정보가 포함되어 있으며 관련 도구를 보다 효율적으로 검색하고 필터링하는 데 도움이 됩니다.
툴허브에 있는 대부분의 레코드는 원래 헤이의 디렉토리용으로 게시된 toolinfo.json 데이터에서 파생되며 1.0.0 toolinfo.json 스키마입니다. 이것은 커뮤니티가 사용하는 도구에 대해 채우기 위해 작업을 시작할 수 있는 많은 격차가 있음을 의미합니다.
최근에 추가된 주석 기능을 사용하면 기본 도구 정보 레코드가 카탈로그에 포함된 방법에 관계없이 누구나 각 도구에 대한 많은 정보 속성을 채울 수 있습니다. 이러한 새 속성에는 다음이 포함됩니다:
- API URL
- 번역 URL
- 버그 추적기 URL
- 사용자 문서 URL
- 개발자 문서 URL
- 피드백 URL
- 개인 정보 보호 정책 URL
- 아이콘
- 도구 유형
- 사용 가능한 UI 언어
- 위키용
- 더 이상 사용되지 않음
- 실험적
- 대체
| 제안된 값을 포함하여 이러한 필드에 대한 자세한 내용은 도구정보 스키마 파일을 참조하십시오. |
편집 방법
- 툴허브의 검색 페이지로 이동
- 편집할 도구를 검색하거나 도구를 선택합니다.
- 도구 카드를 클릭합니다:
- 편집 버튼을 클릭합니다:
- 가능한 한 많은 필드를 채우고 변경 사항을 게시합니다:
- 완료!
기술 기여도
기술적 기여를 환영합니다. 해커톤 2022 워크보드의 "해킹 프로젝트" 및 "신규 사용자를 위한 프로젝트!" 열에서 "툴허브" 태그가 있는 여러 작업을 찾을 수 있습니다. "해킹 프로젝트" 열의 작업에는 자바스크립트 및 프런트 엔드 개발에 대한 사전 지식이 필요합니다.
또한 기본 툴허브 워크보드에서 작업을 선택하거나 툴허브와 상호 작용할 때 사용자 경험을 기반으로 자체 개선 및 버그 수정을 제안할 수 있습니다.
계정 설정
이전에 위키미디어 프로젝트에 기여한 적이 있다면 이 섹션을 건너뛸 수 있습니다. 그렇지 않은 경우 다음을 수행해야 합니다:
- 개발자 계정 만들기
- [[mw:Special:MyLanguage/Phabricator/Help|파브리케이터 계정 설정]
- Git 및 Gerrit 설정
개발 환경 설정
여기 지침에 따라 개발 환경을 설정하십시오.
기여 워크플로우
- "Clone with commit-msg hook" 옵션을 사용하여 툴허브 프로젝트를 복제합니다.
- 컨테이너 빌드 및 실행(위의 "개발 환경 설정" 참조)
- 코드를 일부 변경
- 테스트가 성공적으로 실행되는지 확인
$ make test
- 설치할 새 노드 종속성을 실제로 지정하지 않은 경우 package-lock.json을 재설정합니다.
$ git checkout package.json
- 변경 사항 커밋
$ git commit --all
- 가이드라인에 따라 커밋 메시지의 형식을 지정합니다.
- 검토를 위해 변경 사항(Git 용어로 패치 세트) 제출
$ git review -R
- 누군가 귀하의 패치를 검토합니다:
- 문제 없나요? 패치 세트는 +2를 받고 병합됩니다. 성공! (하지만 코드가 즉시 검토되지 않으면 인내심을 가지십시오)
- 검토자가 변경을 요청합니까? 절망하지 마십시오. 이것이 가장 가능성이 높은 시나리오입니다. 커밋을 수정하고 새 패치 세트를 제출합니다. 자세한 방법은 Gerrit 자습서 tl:dr 끝에 있습니다.
기여하는 다른 방법
누구나 데모 서버를 사용하여 앱으로 작업을 수행하고 예상보다 어렵거나 혼란스러워 보이는 것에 대한 버그 보고서/기능 요청을 제출할 수 있습니다.
질문 및 피드백
토론 페이지에 질문과 피드백을 남겨주세요. 이것은 우리가 모니터링하고 빠른 답장을 받을 가능성이 가장 높은 페이지입니다. :)
특정 작업에 대해 논의하고 싶다면 파브리케이터에 질문과 의견을 남겨주세요.