툴허브/해커톤 2022

From Meta, a Wikimedia project coordination wiki
This page is a translated version of the page Toolhub/Hackathon 2022 and the translation is 100% complete.

위키미디어 해커톤 2022는 기술 프로젝트에서 함께 작업하고, 새로운 기술을 배우고, 다른 기술 기여자를 만날 수 있는 무료 이벤트입니다. 2022년 5월 20일부터 22일까지 온라인으로 개최됩니다.

툴허브는 위키미디어 운동에 사용되는 소프트웨어 도구의 커뮤니티 관리 카탈로그입니다. 기술 지원자는 툴허브를 사용하여 자신이 만들거나 유지 관리하는 도구를 문서화할 수 있습니다. 모든 위키미디어인들은 툴허브를 사용하여 작업 흐름에 도움이 되는 도구를 검색하고 다른 사람과 공유할 유용한 도구 목록을 만들 수 있습니다.

이 페이지는 해커톤이 열리는 주간에 추가 정보로 업데이트됩니다. 다시 체크인하십시오!

물론 작업 및 개선 사항에 대한 제안 사항이 있으면 여기에 추가하십시오.

참여 방법

참가 조건은 없습니다. 오랫동안 기술에 기여해 온 사람이든, 호기심 많은 신입이든, 그 사이에 있는 어떤 사람이든 모두 환영합니다. 위키미디어의 기술 공간우호적인 분위기 정책에 대한 행동 강령을 따르도록 요청합니다.

다음은 툴허브를 처음 사용하는 경우 유용한 리소스입니다:

세션

슬라이드
발표자 노트가 포함된 슬라이드

해커톤 기간 동안 인프라 도구실에서 50분간 소개 세션이 진행됩니다. 세션은 두 가지 다른 시간에 열리며 시간대에 가장 적합한 시간을 선택할 수 있습니다:

이 세션에서는 툴허브 프로젝트에 대해 배우고 이를 사용하여 봇, 웹 서비스, 사용자 스크립트, 소도구, 복합 템플릿 및 루아 모듈에 대한 작업을 다른 위키미디어인에게 공개하는 방법을 배울 수 있습니다.

도구 허브 기록 편집

도구정보 기록은 툴허브의 핵심입니다. 여기에는 특정 도구에 대한 사용 가능한 정보가 포함되어 있으며 관련 도구를 보다 효율적으로 검색하고 필터링하는 데 도움이 됩니다.

툴허브에 있는 대부분의 레코드는 원래 헤이의 디렉토리용으로 게시된 toolinfo.json 데이터에서 파생되며 1.0.0 toolinfo.json 스키마입니다. 이것은 커뮤니티가 사용하는 도구에 대해 채우기 위해 작업을 시작할 수 있는 많은 격차가 있음을 의미합니다.

최근에 추가된 주석 기능을 사용하면 기본 도구 정보 레코드가 카탈로그에 포함된 방법에 관계없이 누구나 각 도구에 대한 많은 정보 속성을 채울 수 있습니다. 이러한 새 속성에는 다음이 포함됩니다:

  • API URL
  • 번역 URL
  • 버그 추적기 URL
  • 사용자 문서 URL
  • 개발자 문서 URL
  • 피드백 URL
  • 개인 정보 보호 정책 URL
  • 아이콘
  • 도구 유형
  • 사용 가능한 UI 언어
  • 위키용
  • 더 이상 사용되지 않음
  • 실험적
  • 대체

편집 방법

  • 툴허브의 검색 페이지로 이동
  • 편집할 도구를 검색하거나 도구를 선택합니다.
  • 도구 카드를 클릭합니다:
  • 편집 버튼을 클릭합니다:
  • 가능한 한 많은 필드를 채우고 변경 사항을 게시합니다:
  • 완료!

기술 기여도

기술적 기여를 환영합니다. 해커톤 2022 워크보드의 "해킹 프로젝트" 및 "신규 사용자를 위한 프로젝트!" 열에서 "툴허브" 태그가 있는 여러 작업을 찾을 수 있습니다. "해킹 프로젝트" 열의 작업에는 자바스크립트 및 프런트 엔드 개발에 대한 사전 지식이 필요합니다.

또한 기본 툴허브 워크보드에서 작업을 선택하거나 툴허브와 상호 작용할 때 사용자 경험을 기반으로 자체 개선 및 버그 수정을 제안할 수 있습니다.

계정 설정

이전에 위키미디어 프로젝트에 기여한 적이 있다면 이 섹션을 건너뛸 수 있습니다. 그렇지 않은 경우 다음을 수행해야 합니다:

  1. 개발자 계정 만들기
  2. [[mw:Special:MyLanguage/Phabricator/Help|파브리케이터 계정 설정]
  3. Git 및 Gerrit 설정

개발 환경 설정

여기 지침에 따라 개발 환경을 설정하십시오.

기여 워크플로우

  • "Clone with commit-msg hook" 옵션을 사용하여 툴허브 프로젝트를 복제합니다.
  • 컨테이너 빌드 및 실행(위의 "개발 환경 설정" 참조)
  • 코드를 일부 변경
  • 테스트가 성공적으로 실행되는지 확인
$ make test
  • 설치할 새 노드 종속성을 실제로 지정하지 않은 경우 package-lock.json을 재설정합니다.
$ git checkout package.json
  • 변경 사항 커밋
$ git commit --all
$ git review -R
  • 누군가 귀하의 패치를 검토합니다:
    • 문제 없나요? 패치 세트는 +2를 받고 병합됩니다. 성공! (하지만 코드가 즉시 검토되지 않으면 인내심을 가지십시오)
    • 검토자가 변경을 요청합니까? 절망하지 마십시오. 이것이 가장 가능성이 높은 시나리오입니다. 커밋을 수정하고 새 패치 세트를 제출합니다. 자세한 방법은 Gerrit 자습서 tl:dr 끝에 있습니다.

기여하는 다른 방법

누구나 데모 서버를 사용하여 앱으로 작업을 수행하고 예상보다 어렵거나 혼란스러워 보이는 것에 대한 버그 보고서/기능 요청을 제출할 수 있습니다.

질문 및 피드백

토론 페이지에 질문과 피드백을 남겨주세요. 이것은 우리가 모니터링하고 빠른 답장을 받을 가능성이 가장 높은 페이지입니다. :)

특정 작업에 대해 논의하고 싶다면 파브리케이터에 질문과 의견을 남겨주세요.