アカウント名:
パスワード:
ドキュメントはプログラマじゃなくてもできる貢献って扱いですね。でもコミュニティの話の本流に入っていくにはコードに触れていったほうが早い。あとはRCとかbeta使ってバグ報告すること...かな。
この辺に少し足を突っ込んでみるとコミュニティの奥のほうの本質が垣間見えて、さらに踏み込むかどうかの選別にはなるという。
> でもコミュニティの話の本流に入っていくにはコードに触れていったほうが早い。
そうとは限らないですよ。ドキュメントにこそ、何をやりたいのか、どうあるべきか、といった意図や意志に関わる部分が表れますから、ドキュメントを書いて査読を受ける過程でそういった部分を理解したり、議論したり、それが自分に合っているかを見極める助けになります。もちろん、プロジェクト全体の目的に関するドキュメントをいきなり書くということはありませんが、ごく一部の部品に関するドキュメントであったとしても、全体設計の中のどういう位置づけか、といった考え方が反映されますし。
そういった部分の議論のなかで、コミュニティ内において自分の考え方や立ち位置を分かってもらったり、信用を得たりすることにもつながります。そういう考え方を分かってもらった上でコードを提供すると、そのコードが追加する新機能を単に表面的に理解してもらうだけでなく、なぜその機能が(今後ずっとメンテナンスしなければならないという負荷を負ってまでも)あるべきなのか、という思想にかかわる部分を理解してもらいやすくなります。
べつに、最初からコードに触れることを否定するわけではありませんが。
日本人だと「ドキュメントとかメッセージの日本語訳で貢献」という罠がある。元になるドキュメント開発ではないのでソフトウェア本体を開発してるエンジニアとの作業は少なくてエンジニアに揉まれて何かを作る力を身につけたい時には訳にたたねえ。
# ただし「コミュニティで活動してます!」と言って転職に役立てるのが目的なら和訳だけで十分ダマせる :-P
プログラミング的な技術の向上には繋がらないかもしれないが、ローカライズは重要な作業だし、罠だの騙すだのマイナス要素の単語を使うってのはどうなんだ?そもそも元コメントのタイトルが「プログラマじゃなくたって」なのに。
>エンジニアに揉まれて何かを作る力を身につけたい時には訳にたたねえ。そういう目的なら別にドキュメンテーション選ばないだろ?
ドヤ顔のところすまないが、オープンソースプロジェクトへの貢献とは別の話だな。
何かを作ろうと考えた時に、ドキュメントを作成した経験自体は役にたつと思うよ。
特によく出来たドキュメントの翻訳だと、よい経験になるかと。オープンソースだから、ドキュメント作成にもソース読むことも多いだろうし
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
UNIXはただ死んだだけでなく、本当にひどい臭いを放ち始めている -- あるソフトウェアエンジニア
プログラマじゃなくたって (スコア:1)
ドキュメントはプログラマじゃなくてもできる貢献って扱いですね。
でもコミュニティの話の本流に入っていくにはコードに触れていったほうが早い。
あとはRCとかbeta使ってバグ報告すること...かな。
この辺に少し足を突っ込んでみるとコミュニティの奥のほうの本質が垣間見えて、さらに踏み込むかどうかの選別にはなるという。
Re:プログラマじゃなくたって (スコア:4, 興味深い)
> でもコミュニティの話の本流に入っていくにはコードに触れていったほうが早い。
そうとは限らないですよ。
ドキュメントにこそ、何をやりたいのか、どうあるべきか、といった意図や意志に関わる
部分が表れますから、ドキュメントを書いて査読を受ける過程でそういった部分を
理解したり、議論したり、それが自分に合っているかを見極める助けになります。
もちろん、プロジェクト全体の目的に関するドキュメントをいきなり書くということは
ありませんが、ごく一部の部品に関するドキュメントであったとしても、全体設計の
中のどういう位置づけか、といった考え方が反映されますし。
そういった部分の議論のなかで、コミュニティ内において自分の考え方や立ち位置を
分かってもらったり、信用を得たりすることにもつながります。そういう考え方を
分かってもらった上でコードを提供すると、そのコードが追加する新機能を単に表面的に
理解してもらうだけでなく、なぜその機能が(今後ずっとメンテナンスしなければならない
という負荷を負ってまでも)あるべきなのか、という思想にかかわる部分を理解して
もらいやすくなります。
べつに、最初からコードに触れることを否定するわけではありませんが。
Re:プログラマじゃなくたって (スコア:1)
日本人だと「ドキュメントとかメッセージの日本語訳で貢献」という罠がある。
元になるドキュメント開発ではないのでソフトウェア本体を開発してるエンジニアとの作業は少なくて
エンジニアに揉まれて何かを作る力を身につけたい時には訳にたたねえ。
# ただし「コミュニティで活動してます!」と言って転職に役立てるのが目的なら和訳だけで十分ダマせる :-P
Re:プログラマじゃなくたって (スコア:1)
プログラミング的な技術の向上には繋がらないかもしれないが、ローカライズは重要な作業だし、罠だの騙すだのマイナス要素の単語を使うってのはどうなんだ?
そもそも元コメントのタイトルが「プログラマじゃなくたって」なのに。
Re: (スコア:0)
>エンジニアに揉まれて何かを作る力を身につけたい時には訳にたたねえ。
そういう目的なら別にドキュメンテーション選ばないだろ?
ドヤ顔のところすまないが、オープンソースプロジェクトへの貢献とは別の話だな。
Re: (スコア:0)
何かを作ろうと考えた時に、ドキュメントを作成した経験自体は役にたつと思うよ。
特によく出来たドキュメントの翻訳だと、よい経験になるかと。
オープンソースだから、ドキュメント作成にもソース読むことも多いだろうし