日本語でどうぞ。
NodeSchoolをやっていてわからないところがありますか? 質問を新規作成
NodeSchool の主催者は こちら でディスカッションしています. あなたが自分で NodeSchoolのワークショップ(Workshop) を作りたい場合は、こちら(workshoppers repo) をご覧ください.
はじめの一歩: 1 - 親切に; 2 - すべて公開の場で; 3 - 忍耐が必要なときもあります; 4 - 日本語でOKです
質問する前に: インストールの確認; すべての出力を教えてください; Markdownを活用しましょう; 『ありがとう』; 質問(issue)を閉じます; 待てば海路の日和あり
質問に答える: リンクを使いましょう, 質問で終わると……, 質問(issue)を再編集, 優先順位の適用, 質問(issue)を閉じる
👉 まずFAQを確認してください! 👈
ワークショップの作成やディスカッションへの回答はすべて無償のボランティアでおこなわれています。 もし、あなたが否定的で建設的でない批判をするようであれば、あなたの質問には誰も答えてくれなくなるでしょう。
ワークショップの作者に直接メールを送るのではなく、公開されたディスカッション(issue)を使って、すべての人がそれを見られるようにしてください。
1日や2日たってから返事がくることもあります。同じメッセージを何度も投稿するのはやめてください。そんなことをしても、早く返事をもらえるわけではありません。
もともと、世界中でつかうためのディスカッション用に nodeschool/discussion が用意されていたのですが、日本語でのディスカッションをやりやすくするために、このレポジトリを作成しました。日本語で思う存分、活用してください。
Windowsでのインストール方法が 問題になること(英語) がよくあります。 それ以外に、他のOS上でトラブルが起きる場合もあります。インストールに問題がある場合は インストールについて(英語)を確認してみると、問題の解決につながる場合があります。
質問に添付する場合は、すべての出力を含めるようにしてください。そうすることで、必要以上のやりとりをすることなく、問題が解決する可能性が高くなります。
また、必要と思われる場合は node, npm, git 等のコマンドのバージョンを質問に含めると問題の解決に繋がる場合もあります。 node -v, npm -v などで確認することができます。
Github では質問を書くときに markdown記法 を使うことができます。 わかりやすい質問や回答を書くために markdown記法 を活用してください。
助けてもらったら、ちゃんと『ありがとう』を言いましょう。みんな笑顔で気持ちよく使えるように……。
疑問が解決したら質問(issue)を閉じ(close)てください。いつまでも閉じられないと、だれかがその仕事をしなくちゃいけなくなります。
すぐに回答をもらえない場合もあります。回答をもらえないまま日がすぎてしまった場合は、あなたがまだその質問に対する回答が欲しいことを表明するため14日程度を目安に質問を更新しましょう。 bikeshed
質問の作成者(owner)は質問にラベルを付けることができます。 やりとりがわかりやすくなるように、いくつかのラベルを定義してありますので、活用してください。 それぞれのラベルの意味は以下のようなものです:
| ラベル | 意味 |
|---|---|
| もっと回答を! | この質問は、まだまだ継続して回答を募集しています。一定期間、回答がもらえない場合など |
| ヒント | 他の質問や実際のコーディングにも有用なヒントが含まれています |
| node.js | node.js自体についての質問・疑問 |
| インストール | node.jsやワークショップのインストールに関連する質問 |
| Mac | Mac OS X に関連する質問 |
| Win | Windows に関連する質問 |
| Linux | Linux に関連する質問 |
| 愛をください | 質問内容が複雑・難解で適切な回答がなかなか得られず、より上級者の協力が欲しい場合 |
| 自己解決済 | 質問したものの、自分自身で解決できてしまった場合に、このラベルを付けて質問を閉じてください |
| 解決済 | 閉じられてはいないのに解決済の質問にこのラベルが付けられます |
| 質問 | 問題があるわけではなく、ただ質問のみの場合にこのラベルを付けます |
| 要フィードバック | 回答済だけれども、さらにフィードバックを待っている場合にこのラベルを付けます |
ラベルを追加する場合に権限を気にする必要はありません。githubでは 所有者のみがラベルを追加できます。
質問(issue)の内容にラベルが見付けられなかったときは、ラベルを追加してここに追記してください。
所有者か否か: もしあなたが質問に対する回答を持っている場合、躊躇せず回答してあげてください。このディスカッションはボランティアベースでなりたっています。
下に書いたいくつかのことを気にとめておいてもらえると、よりよいディスカッションができるのではないかと思います。
いくつもの似たような質問がでてくると思います。他の質問へのリンクを示して簡単に回答することができることもあるかもしれません。 ただし、リンクには適切な説明をつけるのを忘れないようにしましょう。
あなたがコメントで質問した場合、もとの質問者が質問(issue)を修正しなければならないことを示しています。 例えば……
- 自分でやってみましたか?
- それはあなたの役にたちますか?
- 解決しましたか?
- なにかこれ以外の情報が必要ですか?
(訳註: この文章、なにがいいたいのかよくわからないです。ごめんなさい)
質問者 (issueの所有者) は質問を再編集することができます。一度登録した質問の内容を変更するのは、あまりいい考えとは言えませんが、強調部分を追加したりして、読みやすくするのはいい考えだと思います。
In case you feel confident to answer multiple issues it might be a good idea to follow priorities. An example for priorities might be:
- Issues with no labels: Add labels
- Issues with no comments: Think of an answer
- Issues that are least recently updated: Add the
waiting-for-responselabel in case its not given and ask a question in case none has been asked. - Issues that
need-some-love: Try to think how to resolve those because they need your love! - Old Issues that are
waiting-for-feedbackClose them and mark asseems-self-resolvedif they are more than a month old
If you see an old issue lurking around feel free to apply labels as mentioned above and close the issue if reasonable!