News for hackers. Stuff that matters.
Re:Who controls glibc? by __s on Monday May 07, 2018 @09:13PM (#17018016)
Yeah, Python docs need to stop using variable names like 'spam' & 'eggs', Monty Python's too jokey, no room for it in docs
Re:Who controls glibc? by geofft on Monday May 07, 2018 @10:03PM (#17018258)
If you genuinely believe that these are comparable situations (and you're not just making a strained comparison to argue in favor of the side you favor), I'm not sure how to explain my position to you.

Although I think I would start by saying this: where "spam" and "eggs" is used in Python, it is in the place of any other word, usually a nonsense word like "foo" or "bar", and its presence does not distract. I doubt anyone thinks of actual SPAM or actual eggs when they run across it, and I seriously doubt the documentation authors intended or expected anyone to.

The (so-called) joke in this glibc discussion is a) essentially a pun on the name of the function, i.e., introducing mental confusion; b) a political subject; c) an ill-explained reference to a political subject (did you know it's about the global gag rule? do you know what the global gag rule is?); d) intended to make you think about that subject instead of tuning it out.

Python's use of "spam" and "eggs" adds some character, that's about it. (Python's insistence on "eggs" and "wheels" and "cheeseshop", on the other hand... I find the names cute but if you wanted to get rid of them all in favor of slightly more descriptive words, I'd honestly be in favor.) This joke serves no purpose other than, at best, to distract the attention of the person looking up documentation onto a completely different subject.

Re:Who controls glibc? by djsumdog on Monday May 07, 2018 @09:23PM (#17018070)
I think that's a little different. Even with the fun variable names, the Python docs are pretty damn professional.

They haven't always been that way. The Python docs back around 2000 were not that great. A lot of work has been put in by people in the community to get them to the state they're in.

Re:Who controls glibc? by dfox on Monday May 07, 2018 @09:53PM (#17018216)
Python docs are very good and professional, but somewhat chaotic unless you have pretty good grasp on what belongs where.

Just last friday I tried to find authoritative definition of the leading underscore mangling behavior in the docs and was not able to do so.

Re:Who controls glibc? by MrsRobot on Tuesday May 08, 2018 @12:35AM (#17018843)
Not the same thing. "spam" & "eggs" are very neutral. If they used politically charged terms, and inserted example code like "if brains(republicans) == 0 # always true!" then the situation would be similar. The difference is between neutral light-heartedness and non-neutral political message.
Re:Who controls glibc? by pferde on Tuesday May 08, 2018 @04:26AM (#17019624)
How do you know which words will and will not become politically charged in fourty years?
Re:Who controls glibc? by geofft on Tuesday May 08, 2018 @05:21AM (#17019770)
You update the docs in forty years as needed.

In any case that question seems wildly unrelated to the question at hand, which is about a joke that's intended to be a present-day political reference.

Re:Who controls glibc? by keiyakins on Tuesday May 08, 2018 @12:56PM (#17022469)
The same way you know what technical details will be needed in forty years: By actively maintaining the documentation, as they're doing.
Re:Who controls glibc? by DoofusOfDeath on Tuesday May 08, 2018 @09:17AM (#17020660)
They're probably just trying to give wide berth of the world's most dangerous joke.