Nov 2023 Mod notice:
There may be other, more specific, threads about some aspects of US politics, but this one tends to act as a hub for all sorts of related news and information, so it's usually one of the busiest OTC threads.
If you're new to OTC, it's worth reading the Introduction to On-Topic Conversations and the On-Topic Conversations debate guidelines before posting here.
Rumor-based, fear-mongering and/or inflammatory statements that damage the quality of the thread will be thumped. Off-topic posts will also be thumped. Repeat offenders may be suspended.
If time spent moderating this thread remains a distraction from moderation of the wiki itself, the thread will need to be locked. We want to avoid that, so please follow the forum rules when posting here.
In line with the general forum rules, 'gravedancing' is prohibited here. If you're celebrating someone's death or hoping that they die, your post will get thumped. This rule applies regardless of what the person you're discussing has said or done.
Edited by Mrph1 on Nov 30th 2023 at 11:03:59 AM
But, from experience, I can also tell you that writing useful documentation and maintaining it is hard. It only gets harder if your documentation isn't intended for someone with technical knowledge.
As for why a lot of things get left undocumented: it's essentially a gesture of goodwill. There is absolutely no incentive to document your code or the usage of your program beyond that which you need except to hypothetically help some future other. Presumably, if you were to be leaving of your own accord, you might have the time and inclination to go through and document things as necessary for whoever comes after you, but outside of that situation you're basically hoping that whoever creates your system either wants to cover for their own death or is happy enough to help the organisation that fires them. Usually, the second one.
The moral of the story is to not expect people to put in hours of work doing something they dislike because it might vaguely help some future unknown figure when the more likely scenario is often "you kicked me out". Which goes for everything, really, not just programming. It's how you lose institutional knowledge, but only when computers are involved do you get so much blatant "I don't know how this works".
Edited by RainehDaze on Sep 17th 2021 at 10:03:29 AM
Avatar SourceRight, which is why companies should do more to reward and encourage such documentation, and allow for enough room to do so. Ultimately, that is in the company's own interest as well, because paying someone after the fact to do the detective work of figuring out what they have is often much more costly in the end.
And with that, I believe we've had enough of a tangent for today. We can continue in the Computer thread, if you like.
Optimism is a duty.As I said, it's just a loss of institutional knowledge, not some weird software development-specific egotism like you were insinuating. Software just crystallises it nearly in specific examples of things people don't know how to do.
It's a general people thing. "Please provide a handbook on how you can be replaced unasked" isn't fun to do or in anyone's own interest.
Edited by RainehDaze on Sep 17th 2021 at 10:14:25 AM
Avatar SourcePeople also generally don't like to think about their own mortality either. "Please prepare this in case you die tomorrow or something" isn't something any employee wants to hear.
Disgusted, but not surprisedWell, perhaps that's just because software is the most directly familiar example to me. Though I think software is a bit of a special case, since the documentation is aimed at other programmers rather than end users.
Optimism is a duty.Also, in the past many programmers have considered bad commenting practices to be Vetinari Job Security.
Which is why smart companies have detailed and specific requirements for commenting code, so they can make sure there's always someone who can understand the first guy's shit.
Oh yes, the job security crowd. I had forgotten about those. They're the same sort of people who build in booby traps to their software so they can screw the company over should they get fired.
Optimism is a duty.I keep telling my bosses that I need a backup, but hey. They are giving me job security out of the generosity of their hearts.
"It's Occam's Shuriken! If the answer is elusive, never rule out ninjas!"This situation reminds me how there's a vital pillar of Internet infrastructure that is maintained by one guy in the middle of nowhere.
Fantastic. You just can't make this shit up. Giving a speech about not being partisan in a building named for Mitch Mc Connell, someone who would love nothing more than to turn the SCOTUS partisan... Who was also present, by the by.
The emperor has no clothes, indeed.
Optimism is a duty.I used to want to become a Christian, but now because of people like her I'd rather become a Satanist than having anything to do with them. At least Satanists have more moral dignity than her, McConnell and the other Christian fundamentalists we have in our government.
Sorry, I just got a little too worked up. I just feel pissed at the idea that I will have to live with that hag in the news for possibly the rest of my life.
Edited by clemont107 on Sep 17th 2021 at 3:46:08 PM
"What do you guys think about my swimsuit?" - CarmineI fail to see how that first part is related to politics.
It's one thing to make a spectacle. It's another to make a difference.I mean, there are plenty of perfectly good reasons to not want to become a Christian, but don't let the SCOTUS stop you, y'know.
Optimism is a duty.And we can discuss them all in the thread here about religion.
It's one thing to make a spectacle. It's another to make a difference.What's the deal with that? Did France start hating Australia while I wasn't looking?
I haven't followed but my understanding is the US spannered a deal France was negotiating with Australia.
Edited by sgamer82 on Sep 17th 2021 at 12:56:28 PM
France just lost a contract deal and they are being pissy over it.
The French were selling them Diesel powered submarines
lawl
Edited by Ultimatum on Sep 17th 2021 at 8:11:47 AM
New theme music also a boxInteresting update on the California recall: While the polls did indicate that Newsom was going to win, they were around a +15 point margin. While the official ballot counting won't be finished for another few decades weeks, right now it looks like he won with a +25 point margin.
Like I said before, the tried and trued tactic of withdrawing your ambassadors to show that You Disapprove. Bad US, bad Australia. They'll be back within the month, I'm sure.
Optimism is a duty.Couldn't they have simply send a text saying "Dude, uncool" and be done with it? Why all the theatre?
theatre gets them attention and notoriety,and sympathy from their supposed supporters allies
New theme music also a boxFormer Sen. Heidi Heitkamp now lobbies for tax loophole she called “one of the biggest scams”. This is one article on one topoc but there has been some complaining about the role of her (Heidi Heitkamp) in lobbying for pro-wealthy policies that are not only questionable on their merits but are likely to be electoral liabilities b/c they are the only policies that you can run in a moderate district.
"For a successful technology, reality must take precedence over public relations, for Nature cannot be fooled." - Richard Feynman
It's not just that it is hard to write, it is that many programmers are not inclined to writing and maintaining it, or to having to explain their work to others in general. Some have an attitude that no one but they are able to understand their code, and don't want to "waste time" explaining it, and thus you get the situations where a programmer dies and a company is left with a black box system which no one knows how it works.
Optimism is a duty.