8 ms·

Seems legit. I'd usually prefer documentation to reflect best practices, and sarcastic or satirical stuff would only add some layer of uncertainty or misunders

Seems legit. I'd usually prefer documentation to reflect best practices, and sarcastic or satirical stuff would only add some layer of uncertainty or misunderstanding (as per the maintainer's own commit message). While potentially fun or culturally valuable, I'd prefer such stuff would be external to official documentation. Edit: this twitter thread appears to be the backstory for what led to maintainer deciding to remove it (cw for foul language heh) https://twitter.com/LiaSae/status/1367071124383797256 https://twitter.com/LiaSae/status/1367071124383797256 After reading through the discussions I do have to agree such "fun" is not really contributing to the documentation and just leads to misunderstandings or confusion (such as this very instance). Just didn't really need a bunch of outrage to reach that conclusion IMO :P

NikolaeVarius 6y ago
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
AlexandrB 6y ago
I like how the original complaint-maker mentions multiple times that "there are plenty of valid reasons to encrypt save files besides IAP" without giving examples of what those might be. The lady doth protest too much.
kwdc 6y ago
We require strictly defined areas of uncertainty!
conradfr 6y ago
Expected amount of pronouns in bios on that Twitter thread.
- 1f60c 6y ago
  Please don't do this here.
  - dat_ire_is_said 6y ago
    It's true though. Indeed, it's a useful indicator of the type of so-called leftist whose main concern is scolding others via identity politics, rather than someone with actual left-wing ideals of opposing economic injustice and exploitation (as was done satirically by that now-deleted documentation page). Just goes to show the complainer's priorities really.
    - orthecreedence 6y ago
      > Just goes to show the complainer's priorities really. Taking down capitalism one scolding at a time.
gotostatement 6y ago
Seems like the tweeter's issue is that mocking mobile games and in-app purchases is somehow indirectly joining in on sexism and other "tropes".[0] This seems like complete BS to me. The satire is of capitalism, it's a well-pointed jab at the gaming industry itself, at people who will be using the library for nefarious purposes. The mental gymnastics that turn this from a trenchant anti-capitalist satire into a "punching-down" at women and casual gamers is... breathtaking. My armchair analysis is that this person has made their career in IAP's and mobile gaming, feels personally attacked by the (accurate, biting) critique, and has abused anti-oppressive language to protect their moral ego. [0] https://twitter.com/LiaSae/status/1367074344313237507?s=20 https://twitter.com/LiaSae/status/1367074344313237507?s=20
- JetAlone 6y ago
  I used to briefly work in the IAP gaming world. There was a period of understanding the consequences of my work, and it eventually hit me that it just wasn't right. I know that right now someone's mother is lonely, bored, and compulsively dipping deeper into her savings than is wise to grind her way through content I created. I think I might dislike abusive IAP and have found this tragically funny because I love women.
- dat_ire_is_said 6y ago
  > Seems like the tweeter's issue is that mocking mobile games and in-app purchases is somehow indirectly joining in on sexism and other "tropes". Indeed, and it's yet another sad example of how the modern so-called left are more concerned with tropespotting, and manufacturing outrage over nothing, than anything of actual importance. As a traditional leftist, it saddens me that our movement is being successfully hijacked by these fools.

NikolaeVarius 6y ago

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

AlexandrB 6y ago

I like how the original complaint-maker mentions multiple times that "there are plenty of valid reasons to encrypt save files besides IAP" without giving examples of what those might be. The lady doth protest too much.

kwdc 6y ago

We require strictly defined areas of uncertainty!

conradfr 6y ago

Expected amount of pronouns in bios on that Twitter thread.

1f60c 6y ago
Please don't do this here.
- dat_ire_is_said 6y ago
  It's true though. Indeed, it's a useful indicator of the type of so-called leftist whose main concern is scolding others via identity politics, rather than someone with actual left-wing ideals of opposing economic injustice and exploitation (as was done satirically by that now-deleted documentation page). Just goes to show the complainer's priorities really.
  - orthecreedence 6y ago
    > Just goes to show the complainer's priorities really. Taking down capitalism one scolding at a time.

gotostatement 6y ago

Seems like the tweeter's issue is that mocking mobile games and in-app purchases is somehow indirectly joining in on sexism and other "tropes".[0] This seems like complete BS to me. The satire is of capitalism, it's a well-pointed jab at the gaming industry itself, at people who will be using the library for nefarious purposes. The mental gymnastics that turn this from a trenchant anti-capitalist satire into a "punching-down" at women and casual gamers is... breathtaking. My armchair analysis is that this person has made their career in IAP's and mobile gaming, feels personally attacked by the (accurate, biting) critique, and has abused anti-oppressive language to protect their moral ego. [0] https://twitter.com/LiaSae/status/1367074344313237507?s=20 https://twitter.com/LiaSae/status/1367074344313237507?s=20

JetAlone 6y ago
I used to briefly work in the IAP gaming world. There was a period of understanding the consequences of my work, and it eventually hit me that it just wasn't right. I know that right now someone's mother is lonely, bored, and compulsively dipping deeper into her savings than is wise to grind her way through content I created. I think I might dislike abusive IAP and have found this tragically funny because I love women.
dat_ire_is_said 6y ago
> Seems like the tweeter's issue is that mocking mobile games and in-app purchases is somehow indirectly joining in on sexism and other "tropes". Indeed, and it's yet another sad example of how the modern so-called left are more concerned with tropespotting, and manufacturing outrage over nothing, than anything of actual importance. As a traditional leftist, it saddens me that our movement is being successfully hijacked by these fools.