0207|09|
2007|09|10|12|
2008|01|02|03|
2009|01|05|08|10|11|12|
2010|01|02|03|04|09|11|12|
2011|01|02|03|04|05|06|07|08|09|10|11|12|
2012|01|02|03|04|05|06|07|08|10|11|12|
2013|01|02|03|04|05|06|07|08|09|10|11|12|
2014|01|02|03|04|05|06|07|08|09|10|11|12|
2015|01|02|03|04|05|06|07|08|09|10|11|12|
2016|01|02|03|04|05|06|07|08|09|10|11|12|
2017|01|02|03|04|05|06|07|08|09|10|11|12|
2018|01|02|03|04|05|06|07|08|09|10|11|12|
2019|01|02|03|04|05|06|07|08|09|10|11|12|
2020|01|02|03|04|05|06|07|08|09|10|11|12|
2021|01|02|03|04|05|06|07|08|09|10|11|12|
2022|01|02|03|04|05|06|07|08|09|10|11|12|
2023|01|02|03|04|05|06|07|08|09|10|11|12|
2024|01|02|03|

2017-05-17 「作成プロセス途中の、小さくて、汚い、のソースコードを残して下さい」 [長年日記]

(昨日の続きです)

(Continuation from yesterday)

作成途中の、機能の一部だけを実装した、

I ask the engineers to open a part of source code, that realizes a part of whole function. In addition, the code might be

■汚くて、

lame, unmade

そして

and

■ステップ数が短い(どんなに長くも100行)

shorter (less than 100 steps, if ever)

コードを、バシバシ公開して頂きたいのです。

I really want to read such incomplete codes.

そのようなプログラムは、大抵の場合、アルゴリズムの「根っこ」であったりします。

Those codes are, in many case, fundamental function of the algorithm.

そして、その「根っこ」は、私にとっては、完成した完璧なソースコードより、はるかに価値があるのです。

For me, the code is better for me than complete and completed source code by far.

汚いコードは、データ構造の本質を理解するのに、大変助かりますし、

A lame and unmade code is helpful to understand a basic structure of data, and,

短いコードは、そのアルゴリズムを理解するのに、大変助かります。

A shorter code is helpful to understand the basic algorithm.

特に、実時間処理を施しているコードなどにおいては、その処理を施す前のコードが、私にとっては至宝のコードです。

Especially, about a code that implements realtime processing function, the old code, before implementing the process, is extraordinarily fine, for me.

(実時間処理が入ってくると、トレースができないから)

If the realtime process includes, the code traces must be difficult.

-----

善意でソースコードを公開して頂いている方の多くは、ソースコードを作ることが大好きで、

Many engineers, who have opened their source code with good-will, love to make codes,

そして、

however,

―― ドキュメント(解説資料)を作るのが大嫌い

they don't like write a document(like instruction manual,practical guide)

です。

もし、その方から、「ソースコード自体が、ドキュメントそのものだろう」と言われると、それはもっともな話で、グウの根も出ません。

If they say "source code itself, is a manual" to me, I don't argue against them.

それが、正論だからです。

Because it is a just argument absolutely.

なにより、自分のソースコードを公開している私自身も、ドキュメントは作っていません。

Above all, I also open my source code to the Internet, but I have not made the manual since now.

-----

だから、「ドキュメントを書いて下さい」とは言いませんので、

So I don't say "Please write "readme.txt" down". but I want to say to them

「作成プロセス途中の、小さくて、汚い、のソースコードを残して下さい」

"Please leave your lame, unmade and short code under the construction"

と申し上げさせて頂いている次第なのです。

with greatest courtesy.