「よいサンプルコード」ってどんなサンプルコード？ 〜Qiitaや技術ブログを書くときに気を付けること〜 - Qiita

はじめに Qiitaやブログに技術記事を書く場合は多かれ少なかれ、サンプルコードを書くと思います。 たかがサンプルコード、されどサンプルコード。 技術記事に書くサンプルコードはどうあるべきなのでしょうか？ いろいろな観点があると思いますが、この記事では僕が考える「よいサンプルコード」について語ってみようと思います。 なお、この記事のサンプルコードはRubyで書いていますが、記事の内容自体はRubyに限らずどんな言語にも適用できるものです。 どういったサンプルコードが理想的なのか（大雑把なレベルで） 細かいポイントの説明に入る前に、大雑把なレベルで理想的なサンプルコードについて確認しておきましょう。 以下は僕が考える理想的なサンプルコードです。 読み手（＝見知らぬ第三者）のことを一番に考えて書かれている 読み手がすっと理解できるコードになっている 読み手（特に初心者）を正しい方向に導くコード

[tanakara_botamochi]

"文章とコードの比率に気を付けること（理想は50:50）"

[MasaoBlue]

いつか時代が進んで仕事で書いたコードを勝手にボカして社外に公開できる世の中が来たら良いなと思う。むしろ全てオープンソースになってほしい

[otihateten3510]

動くこと