初心者の方がプログラムの質問をする時に気をつけて欲しい事

どうも、オーカワです。

嬉しいことにほぼ毎日、Twitter, ブログに意見や質問があります。

大概ブログで紹介してる、プログラムについてですね。皆さんが質問をすればするほど、コンテンツのクオリティが上がるので、今後ともよろしくお願いします。

質問に対して思うことがあるので、今回記事にした次第でございます。

オーカワ

偉そうでごめんなさい。先に謝っておきます

Contents

1 まず質問する時はTwitter, コメントどっちがいいの?
2 プログラムの質問について
3 良い質問は良い返答を生みます
- 3.1 良くない質問(実体験に基づいて作成)
- 3.2 良い例
4 余談

まず質問する時はTwitter, コメントどっちがいいの?

正直読者目線で言うと、どちらでも良いってのが本音です。質問の返答さえあればいいですからね。

しかし、私(ブログ)目線だとコメントです。

コメントで質問していただくと、ブログの中にコンテンツとして残り、読者の皆様は全員見ること(共有)が出来ます。質問の内容によって、記事のクオリティが上がることや、他の読者の皆様に知見として残ります。これは非常にありがたいです。

しかし、Twitterでは共有が出来ません。

僕の所に来るのは9割程Twitterなんですけどね(笑)。僕がよくTwitterに張り付いているのと、ブログよりもはっちゃけてるので、質問しやすいのが理由なのかな?あと、他の人に見られないとか......

Twitterに関しては、よくDM(ダイレクトメッセージ)で質問をされる方がいます。DMで送られると他の読者様が完全に見ることが出来ないので、個人的にはあまりして頂きたくなく(DMでしか質問できないようなネタもございます)。

自分のわからない事を人に聞くのって、恥ずかしいですよね。しかも、他の人に見られていると。しかし、その質問がより良いコンテンツを生みます。だから質問出来る人って凄いですよね。学校の授業でも質問をした人が加点を貰っているのも頷けます。

オーカワ

こういう意見もあるよ。位に覚えておいてくれよん

プログラムの質問について

僕の書く記事は、ほとんどが初心者向けのプログラム記事ですので、質問が多いです。特にノンプログラマー(初心者)の。

質問はどれだけ自分がわかっていて、どれだけ自分がわかっていないかが重要だと思います。

結構質問を貰っても、こちらが逆に質問をする事が多いです。出来れば1回の会話で終わらせたいですよね。質問が上手い人もいれば、上手くない人もいるので、質問が確実に少なくなるテクニックをここで共有出来ればと思います。

質問する前にエラーを読もう

大抵の問題はここで解決します(笑)。

というか皆様エラーを読まなすぎです。皆様というか、僕の周りの大学生でさえも、プログラムが苦手という人はエラーを読んでないです。非常にもったいないですね。

最近のコンパイラはとても優秀なので、間違った所をほぼ的確に教えてくれます。昔は割とポンコツでしたが、今は凄いですよ。本当に。

オーカワ

えっ英語がわからないって?そんな時はGoogle翻訳を使おう

エラーを、質問と一緒に送ろう

僕もありますが、エラーを見てもわからない事だってあります。ググってもわからない時だって。

そういう時は知っている人に聞くのが一番早いです。エラーコードを贈り送りましょう。

気をつけて欲しいのは1点だけ。もれなく送ること。

エラーの一部をわかっていると思い込んで、その部分は送らずに、他のエラーだけを送る人がいます。

しかし、わかっていると思い込むのが落とし穴だったりするので、全部送るほうが良いです。

質問に対応する人は、それが全てのエラーだと思い込んで、見ますからね。

ソースコードを送ろう

エラーだけだとわからない時もありますので、ソースコードも一緒に送るのがベターですね。

わかる人が見れば、大抵の事はすぐ解決できますので。

気をつけて欲しいのは1点だけ。画像(スクショ)で送らない事。

ソースコードでは出来る様々な検証や便利な機能が、画像の場合では出来ません。

ソースコードは少ない行数だったら、そのままコピペして文章で送って頂いてもいいですし、多ければ色々な方法で送ってください。推奨はGitHubですが、初心者の方は難しいと思うので、Googleドライブでも使って頂けたらなと(このご時世いくらでも方法があると思います)。

良い質問は良い返答を生みます

良くない質問(実体験に基づいて作成)

オーカワ

ブログの〜〜という記事よんで、プログラムをコピペして、実行してみたんだけど、
動かないよ。なんで？

オーカワ

うーんと、エラーなどでていますか??

オーカワ

はい。出ています

今夜は長い

良い例

オーカワ

ブログの〜〜という記事読んで(中略)実行出来ませんでした。
エラーは
IndentationError: expected an indented block
と出ています(よくわかりません)。
コードはコピペ通り、
1 #!/usr/bin/env python3
2
3 if __name__ == '__main__':
4 print("aaa")
です。

オーカワ

お、インデントがずれていますね。4行目のprint文をタブで1回ずらしましょう。

オーカワ

出来もうした!!

すっきり