  |
個人的には数学とかの言い回しに寄せればいいじゃないかと思います
前提として、「誰にでも同じ説明をして、かつ「例外」もふくめて伝えたい」のであればまず「誰」かを絞らなくてはいけないですよね。ふんだんな説明をする技術書でも読者に前提知識を想定しているように、前提知識を仮定してそれをクリアした人にのみ使えるのだと思います。
また、例外が言い尽くせるのなら「基本的にAはBです。ただしAはCであることもDであることもあります」式で行けますが例外が大量にあるのなら「AはBです。ただしAにはこれこれの性質を持ったものなら全て当てはまります」式で解決するしかないわけですよね。あるいはA(A以外にもあるけどあとで説明する)とか
で、一単語も例文のことを知らない私としては、すくなくとも書かれたことのみ伝えたいなら、
ポインタってどういうやつ？→ポインタが指すってどういうこと？→ブランチを指すポインタって何？(単なるコミットとは?)→gitとは?→gitにおけるHEADって？(HEAD以外にもあるらしい？)→gitにおけるHEADはブランチを指すポインタって結局何？→HEAD以外って何があり得て、具体的になにがあるんです？
の順番で説明してもらえると万人に伝わるかなと思いました。
意図が伝わってなかったらごめんなさい
たとえば「gitにおけるHEADとは、ブランチを指すポインタです」と説明したとする。 が、HEADはdetached HEADにすることもできる。 しかし、detached HEADを説明するためには他の知識も必要にな...
個人的には数学とかの言い回しに寄せればいいじゃないかと思います 前提として、「誰にでも同じ説明をして、かつ「例外」もふくめて伝えたい」のであればまず「誰」かを絞らなくて...
横だけど、それいいね。 用語(概念)を集合論的にとらえると、その概念のスコープが定まりやすくなる。例外についても集合が伝わっていれば自己判断できるようになるだろう。 そのよ...
すまん、一つ前提を忘れていた。 「短く（できるだけ短く）」だ。 なぜなら長いと読まない人が出てくるから。 読まない人は放っておけばいいという立場はとらない前提。 あと「誰」...
古典だが、Joel on Software を読むといいよ。 抽象化には必ず漏れがあるんだよ、ってJoelも言ってます。 https://www.joelonsoftware.com/2002/11/11/the-law-of-leaky-abstractions/ いまどきは英語も機械翻訳で...
日本語読めるようになってから来て
Loveとは何ですか 愛です 進次郎ならそう言うよ
10
