A historian-turned-software engineer warns that “so little is ever written down” by professional programmers in a new article for Fast Company:

Perhaps there’s an early design doc, but then it turns out that everything was substantially revised before work began. Maybe there are a few wiki pages explaining known issues, some of which were solved a long time ago and others that have been left to molder in the codebase. Somebody might have left a comment in the code itself, but typically it’s a warning not to change something or else something else will break… Software engineering has an ambivalent relationship with documentation. Everyone agrees documentation matters in theory, but in practice it’s inconsistent, outdated, or missing entirely. Part of that is simple inertia. Writing documentation is usually less interesting than writing the code itself. But it’s also ideological. The Agile movement emerged in part as a reaction against the heavily documented Waterfall methodology, and one of Agile’s core values explicitly prioritizes “working software over comprehensive documentation.” In escaping bureaucratic overdocumentation, the industry also normalized underdocumentation.

High turnover at software jobs always brings “a constant drain of domain knowledge.” And he’s he’s skeptical that generative AI will be able to fill in those gaps:

[H]aving it generate documentation on the codebase itself might sound like a solution to the absence of other written information. LLMs can certainly summarize code back to you. But hold up with that idea. Beyond hallucinations, there’s a deeper problem: Writing documentation is itself part of the thinking process. Whether I’m writing history or software, putting an approach into words helps refine it before I sink hours into implementation. Documentation also captures intent. An LLM may be able to summarize what a codebase does, but it cannot reliably explain why a developer chose one approach over another, or what trade-offs shaped that decision…

An LLM can read code that I’ve written. It might even scan a large codebase and accurately summarize what it’s doing. But it can’t assess authorial intent.
Thanks to long-time Slashdot reader smooth wombat for sharing the article.

“Around 570 cables (plus a further 80 planned) carry between 95% and 99% of the world’s intercontinental telecommunications data,” reports CNN (since fiber cables offer speeds of terabits per second, carry much more data than satellite links). And “networks of green energy cables carrying electricity are also starting to sprawl across the world’s seabeds.”

Now to protect them, the U.S., Australia and the U.K. “are planning to develop new unmanned undersea vehicles” as part of their trilateral security partnership.

Western governments see a growing risk of Russian and Chinese sabotage of undersea cables and are also concerned that Iran may seek to exploit the many data networks running through the shallow waters of the Persian Gulf. The “seabed is a battlefield” said Australia’s Defence Minister, Richard Marles, in Singapore, calling for tougher action against so-called shadow-fleet vessels… The programme will improve the three nations’ reconnaissance and strike capabilities, “and bolster superiority in anti-submarine and anti-surface warfare,” as well as mine countermeasures, [according to a statement from their trilateral AUKUS partnership]… The new AUKUS project will sharpen all three countries’ ability to respond to threats, including those targeting underwater cables and pipelines, through a range of “cutting edge sensors and weapons systems for undersea drones,” UK Defence Secretary John Healey said.

Marles said undersea internet cables — “the arteries of modern civilization” — were being cut at an unprecedented rate, with island nations like Australia acutely vulnerable. “Over the past 18 months, we have witnessed a series of attacks against subsea critical infrastructure at a scale and frequency that is historically unprecedented,” he said. The UK government has also highlighted the vulnerability of the world’s digital highways. “Every international payment, every cross-border trade executed in milliseconds, every flow of data between businesses here in the UK and markets overseas — all travel along the seabed,” Telecoms Minister Liz Lloyd said Friday… Last month, the UK said it had tracked three Russian submarines covertly surveying undersea cables in the north Atlantic… A UK parliamentary inquiry warned last year that UK infrastructure might be targeted in a crisis, adding it was “not confident that the UK could prevent such attacks or recover within an acceptable time period.”

The UK Navy is already exploring the creation of a hybrid force that incorporates the widespread use of underwater drones to combat Russian threats in the Atlantic.