osu! wikiの改善に興味を持ってくださりありがとうございます! このクイックスタートガイドはGitHubを使って作業をしたことがない、もしくはosu! wikiの作業をしたことがない人のために作られました。 もしあなたにGitHubを使った経験があれば、このガイドを遠慮なくスキップして、通常のフィーチャーブランチ作業に則って、リポジトリの内容をアップデートしてください。
もし作業中に困ったことができたり、助けが必要になったりしたら、遠慮なくosu!dev Discord (#osu-wiki
チャンネル)にメッセージを送ってください。
osu-wiki
リポジトリを開いてください。
Fork
をクリックしてください。
もう一度Fork
をクリックしてあなたがフォークしたリポジトリに進んでください。
下の画像のように、ppy/osu-wiki
リポジトリのフォークを作り、現在それを開いていることを確認してください。
フォークを同期するへ続けてください。
自分のosu-wiki
リポジトリのフォークを開いてください。
ファイルリストの上に、あなたのブランチがppy:master
ブランチと比べて遅れている(behind)、進んでいる(ahead)、または同じ状態にある(even)かが表示されます。もし遅れたコミットと一緒に"behind"もしくは"ahead and behind"と表示されている場合、あなたのブランチは過去のバージョンです。
OK (No commits and not outdated)
OK (These are your commits)
Potentially bad (Your branch is outdated)
Potentially bad (Your branch is outdated with your commits)
もし他の人によってすでに変更されたファイルを変更する予定がない場合、これはさほど大きな問題ではありません。
これを解決するには、My branch is out of date! section in the Common Issues articleを読んでください。
4が完了したら、 オンラインかローカルで編集するへ続けてください。
編集する方法は大きく2つあります。
ちなみに: 編集するのにこれらの方法しか使ってはいけないわけではありません。このガイドを短く簡潔にするために、ここでは他のツールについて多くは語りません。他にも上の2つのような働きをするアプリケーションが存在します。
GitHub Web InterfaceやGitHub Desktopなどで作業を完了させた後で次のセクションへ続けてください。
ppy/osu-wiki
レポジトリを開いてください。
あなたの作業が早ければ、黄色いバナーが表示されます。
もし表示されていれば、 Compare & pull request
ボタンを押してください。 (ステップ8まで飛ばしてください。) もし表示されていなければ、 New pull request
ボタンを押してください。 (ステップ4へ続けてください。)
表示されたページには、以下の写真のような2つのボタンがあります。 compare across forks
ボタンを押してください。
No good.
head fork
ドロップダウンをクリックしてあなたのユーザーネームが入っているものを選んでください。 (2つ目にあるはずです。)
compare
ドロップダウンをクリックしてあなたが作成したブランチを選択してください。 (アルファベット順に並んでいます。)
Create pull request
をクリックしてください。
英語でタイトルを入力してください。タイトルは短くあなたが何をしたかを明白にするようなものにしてください。
文章を翻訳した場合は、2文字の言語名をタイトルの前に入れてください。そして、タイトルはあなたが翻訳した文章の名前にして構いません。例えば、 [JA] BBCode
は日本語で BBCode article を翻訳したことを示すことができます。
説明欄にあなたが変更したことの解説を書いてください。あなたはプルリクエストについて関連することを書くべきです。例えば、進捗状況や、レビュワーに知っておいてほしいことなどです。また、説明欄に"resolves #1" か "closes #1"と書くことでマージされたときにIssueを同時に閉じることができます。(詳しくは Closing issues using keywords を見てください。).
準備ができれば、Create pull request
を押してください。
プルリクエストを一度作成すると、他のosu! wikiの作成者が、あなたのプルリクエストをより良いものにするためにレビューをしてくれるかもしれません。 あなたはそれらのレビューに協力的でなければなりません。 さもないと、あなたのプルリクエストは取り消されるかもしれません! もしあなたのプルリクエストを誰かにみてもらいたければ、osu!dev Discord (#osu-wiki
チャンネル) やGithubのコメントで他のosu! wikiの編集者に聞いてみるといいかもしれません。
あなたの変更をosu! wikiに実際に反映させるためには、あなたのプルリクエストはマージという作業を経る必要があります。あなたのプルリクエストが、レビューされ、承認(approved)されると、Githubのコメント欄やosu!dev Discord (#osu-wiki
チャンネル)でマージしてもらうように尋ねることができます。無事にマージされれば、あなたの変更は5時間ほどで実際にosu! wikiに反映されます。