shamisonn commented 7 years ago

チュートリアルの投稿

チュートリアルを書きました。ひどく雑ですがとりあえずこの内容がわかるような周辺資料が必要なのかな、とか思ったりしてます。

[ ] 筆者確認
[ ] 他者確認

時間がある方、部分的にでもいいのでざっと目を通してください。

問題があった場合
- 「筆者確認」のチェックボックスをはずして、問題を指摘してください
問題なかった場合
- どこまで読んだかをコメントしてください。
- 最後まで読んだ場合、「他者確認」のチェックボックスを入れてください

両方のチェックボックスがチェックされた場合、直ちにマージしてください。

matsub commented 7 years ago

他の言語のtutor考えるとイントロに当たるファイルの名前は統一したいですよね。この方向性だと languages/<lang_name>/introduction.md ですか他に意見ありますかね

matsub commented 7 years ago

あとtutorの説明はもっと雑で網羅的がいいかなと思っていて、

language/
  |__ C/
  |__ python/
       |__ introduction.md
       |__ something.md

となるより、

language/
  |__ C.md
  |__ python.md

で済むような、１言語につき１ファイル、かつ１ファイル大きくなりすぎない、説明しすぎないというのがいいかなと思ってます。実際に書くなら前提として知っておいて欲しい情報が雑に詰まってる感じ

shamisonn commented 7 years ago

たしかに１言語につき１ファイルでイイなって思いますね。全体を事細かく書くのは公式ドキュメントとかでやってたりしますし。

matsub commented 7 years ago

あと内容について、languages/c.mdは”C言語のチューター"にしたくて、つまり、Pythonのチューターを書くとしたら「C、Javaなんかの言語は分かってるけどこれからPythonを始めようかなと思ってる人」向けの内容になると思うんですけど、 Cのチューターでも同じ状態にしたくて、例えば「Java、Pythonは書いてるけど、Linuxツールのコードを詠む必要が出たからCをちょっとやりたい」みたいな人向けの、とりあえず手をつける方法を示すみたいな内容にしたいです。

今の内容はプログラミング自体のが初めての人向けといった感じで、それはまた別のチューターがいいかなと思います。

shamisonn commented 7 years ago

今確認しました。そしたら初学者向けの記事は初学者向けとしてまとめちゃうのが得策ですかね。

shamisonn commented 7 years ago

とりあえず閉じ閉じしとくやつ

PMOB / clue

Create introduction.md #2

チュートリアルの投稿