―― 作った人が言う「簡単」と、それを使う人が直面する「簡単」の間には、100万倍の差がある
"There is a million-fold difference between "easy" as described by those who made it and "easy" as faced by those who use it."
私も長い間、気がつかなったのですが、最近、それを実感しています。
I have not noticed it for a long time, but recently I realized it.
----
最近、私は、他人の作ったシステムを改修するの仕事が多いのですが、この「簡単」の認識のズレで苦しめられています。
Recently, I have been doing a lot of work modifying systems created by others, and I have been suffering from this discrepancy in perception of "easy."
私にとって、私の作ったプログラムやシステムは「簡単」です。
The programs and systems I have created are "easy."
もう、それは『一体、このプログラムの何が分からないの？』というくらいの感じです。
It's like, 'What the heck do you not understand about this program?
しかし、私の作ったプログラムを「改造する人」から見れば、それは「簡単」どころか、ぶっちゃけ「呪文」であり「暗号」です。
However, from the point of view of the "modifiers" of my program, it is not "easy" but rather, quite frankly, a "spell" and a "cipher code."
はっきり言って、『自分で最初から作った方が早いんじゃないかな』と思える程に『難しい』。
To put it bluntly, it is so "difficult" that it would probably be faster to make it yourself from scratch.
これは、自分の作ったプログラムをベースに、だれかに改造を依頼する(ソフト外注さんも含む)時にも同じことが言えます。
This is also true when you ask someone (including software subcontractors) to make modifications based on a program you have created.
It is better not to use 'easy' easily.
特に、他の人の手によってチューンナップされた開発環境やコーディングルールは、(他の人は知りませんが)、私にとっては、
The development environment and coding rules that others have tuned up (I don't know about others) are, to me,
『地獄の開発環境』です。
the 'development environment from hell.'
-----
この話は、「他人」だけではなく「自分」にも当てはまります。
This story applies not only to "others" but also to "myself."
私が、このサイトで、病的なほど技術メモを書き残している理由は、
The reason I am writing morbidly technical notes on this site is,
「過去の自分にとって『簡単』だったものは、時間が経過すれば、それは『地獄』に変化する」
"What was 'easy' for me in the past turns into 'hell' over time."
ということを、誰よりもよく理解しているからです。
I understand this better than anyone else.
私のサイトに来訪頂いている方にとって、"SQLクエリ"だの"Go言語"だの、本当にどーでもいいことですよね。
For those visiting my site, "SQL queries" and "Go language" are unimportant.
でも、私にとっては、このようなメモを残すかどうかは、本当に死活問題なんです。
But for me, whether or not to keep such notes is really a matter of life and death.