Re: [PATCH 0/6] doc: replace "alice" and "bob" examples

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Felipe Contreras <felipe.contreras@xxxxxxxxx> writes:

> I have not read cryptography documentation, so for me Alice and Bob are
> simply two illustrative colleagues.

I have read cryptography documentation and seen Alice and Bob used
commonly.  Am I supposed to be confused if I see those names used in
documentation for non cryptographic software?  If Alice and Bob work
there, why should they not be used here?  Am I missing something?

>> And as argued in 1/6 for those users who /are/ aware of "Alice and Bob"
>> it's needless distraction. Maybe it's just me, but whenever I read
>> references to them I keep waiting for the cryptography angle to be
>> introduced. None of the uses in our documentation reflect that canonical
>> usage.
>
> It's probably not just you, but the vast majority of readers are
> likely not aware of any cryptographic reference.

I find it surprising that anyone would be upset that the names Alice and
Bob were being used in a non cryptographic context.

>> There's also just weird things in our documentation fixed by this
>> series, such as referring to a random file tracked by git as "bob"
>> instead of the more obvious "file.txt".
>
> OK, _that_ I agree it's unequivocally an improvement.

Yea, a file probably shouldn't be called bob... I would probably have
gone with "foo.txt" ( but file.txt is just fine too ).




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux