4 ms·

Man, imagine hating fun even more than old school NASA engineers, the stereotypical anti-fun people. https://github.com/chrislgarry/Apollo-11/blob/cb0da994bb68

Man, imagine hating fun even more than old school NASA engineers, the stereotypical anti-fun people. https://github.com/chrislgarry/Apollo-11/blob/cb0da994bb68343c0795d94118dc2a3a324dbd1f/Luminary099/LUNAR_LANDING_GUIDANCE_EQUATIONS.agc#L1375 https://github.com/chrislgarry/Apollo-11/blob/cb0da994bb6834... https://github.com/chrislgarry/Apollo-11/blob/cb0da994bb68343c0795d94118dc2a3a324dbd1f/Luminary099/THE_LUNAR_LANDING.agc#L245 https://github.com/chrislgarry/Apollo-11/blob/cb0da994bb6834... And if anyone thought this was serious stuff to spend time figuring out if this is real or not, I suspect they have a bigger problem with their reading abilities

amatecha 6y ago
A little inline comment is not the same as an entire documentation page introducing a developer to a process/technique... I don't think the comments in the Apollo 11 code are going to confuse/mislead anyone, nor are they satirical. Quality documentation is factual, to the point, and has minimal chance to mislead or confuse the reader. I can think of multiple people I've worked with over the years who would be confused by the page that was removed, or think it's some weird offtopic political ideological stuff. Satire, due to its figurative nature, is also generally one of the most difficult forms of humour to understand for both autistic/aspergers people and people unfamiliar with the language. Putting "fun" content in your documentation is a balancing act and sometimes the expense (wasting the reader's time/energy or outright confusing them) outweighs the benefit.
- croes 6y ago
  A little confusion from time to time is a good thing, it's an reminder that the real world is confusing too and full of misinterpretation.
  - tubularhells 6y ago
    You are one of the few sane people on this site.
ojnabieoot 6y ago
I shouldn’t have to explain this, but there is a huge difference between - cute comments and snarky method names buried in source code, and - a long, vituperative, divisive rant in the actual documentation It’s not just about “having fun” - there’s nothing “fun” at all in the rant, it’s just unprofessional and irritating.
- cqlake 6y ago
  So, selling addictive in-game purchases to kids and teenagers is professional and mature?
  - ojnabieoot 6y ago
    No, and I really regret engaging with you people on this! comments like this are obviously inappropriate for technical documentation regardless of whether or not you agree with the message: > It is a market of poor souls forced to compulsively consume digital content in order to forget the misery of their everyday life, commute, or just any other brief free moment they have that they are not using to produce goods or services for the ruling class. These individuals need to keep focusing on their video games (because not doing so will fill them with tremendous existential angst)
    - brokencode 6y ago
      Lighten up. Not everything needs to be stuffy and professional. This is an open source project, and if the author wants to include a funny and clearly sarcastic critique of society in the documentation, then that’s up to them. It’s not like this is offensive or NSFW or anything.
- croes 6y ago
  I had fun reading it, so your comment stating there is nothing fun at all is pretty self-centered. Maybe it's good to be reminded, that not all is professional and unambiguous. Just like reality.
- tubularhells 6y ago

amatecha 6y ago

A little inline comment is not the same as an entire documentation page introducing a developer to a process/technique... I don't think the comments in the Apollo 11 code are going to confuse/mislead anyone, nor are they satirical. Quality documentation is factual, to the point, and has minimal chance to mislead or confuse the reader. I can think of multiple people I've worked with over the years who would be confused by the page that was removed, or think it's some weird offtopic political ideological stuff. Satire, due to its figurative nature, is also generally one of the most difficult forms of humour to understand for both autistic/aspergers people and people unfamiliar with the language. Putting "fun" content in your documentation is a balancing act and sometimes the expense (wasting the reader's time/energy or outright confusing them) outweighs the benefit.

croes 6y ago
A little confusion from time to time is a good thing, it's an reminder that the real world is confusing too and full of misinterpretation.
- tubularhells 6y ago
  You are one of the few sane people on this site.

ojnabieoot 6y ago

I shouldn’t have to explain this, but there is a huge difference between - cute comments and snarky method names buried in source code, and - a long, vituperative, divisive rant in the actual documentation It’s not just about “having fun” - there’s nothing “fun” at all in the rant, it’s just unprofessional and irritating.

cqlake 6y ago
So, selling addictive in-game purchases to kids and teenagers is professional and mature?
- ojnabieoot 6y ago
  No, and I really regret engaging with you people on this! comments like this are obviously inappropriate for technical documentation regardless of whether or not you agree with the message: > It is a market of poor souls forced to compulsively consume digital content in order to forget the misery of their everyday life, commute, or just any other brief free moment they have that they are not using to produce goods or services for the ruling class. These individuals need to keep focusing on their video games (because not doing so will fill them with tremendous existential angst)
  - brokencode 6y ago
    Lighten up. Not everything needs to be stuffy and professional. This is an open source project, and if the author wants to include a funny and clearly sarcastic critique of society in the documentation, then that’s up to them. It’s not like this is offensive or NSFW or anything.
croes 6y ago
I had fun reading it, so your comment stating there is nothing fun at all is pretty self-centered. Maybe it's good to be reminded, that not all is professional and unambiguous. Just like reality.
tubularhells 6y ago