"To begin with, everything you document has to be in a format that's as structured and machine-readable as possible. The key here is to disambiguate as much as you can, even if you have to repeat yourself. So, don't bother with the formatting of your documentation or the look and feel of your API portal. Instead, focus on using well-known API definition standards based on machine-readable formats. Use OpenAPI for documenting REST APIs, AsyncAPI for asynchronous APIs, Protocol Buffers for gRPC, and the GraphQL Schema Definition Language. Whenever possible, store the API definitions in several formats, such as JSON and YAML, for easy interpretation by AI agents.

But that's not enough. If you don't have all your operations clearly defined, AI agents will have a hard time understanding what they can do. Make sure you clearly define all operation parameters. Specify what the input types are so there are no misunderstandings. So, instead of saying that everything is a "string," identify each individual input format."

https://apichangelog.substack.com/p/api-documentation-for-machines

#APIs #APIDocumentation #AI #AIAgents #LLMs #OpenAPI #TechnicalWriting #SoftwareDocumentation #Programming

The problem is that most companies with the resources to properly implement role fluidity only want to hire "unicorns." Having worked in hybrid roles at smaller companies before and after the widespread adoption of LLMs, I must say that it's a recipe for burnout. This is not only because it's difficult to assess the quality of your work, but also because, in practice, companies don't care much about documentation. In reality, you'd mostly be a software developer doing some documentation in your "free time."

Another problem with this model of a fluid software documentation team is that it assumes there are or will be software companies willing to prioritize documentation as a sector that deserves its own department. However, technical writers are often placed under the product umbrella, which isn't necessarily bad. In fact, it's much better than being placed under "marketing." Unfortunately, if role fluidity ever becomes the norm, I'm afraid it will most likely start with engineering.

https://passo.uno/docs-team-of-the-future/

#TechnicalWriting #SoftwareDocumentation #Programming #SoftwareDevelopment #AI #LLMs

"I begin with the view that, and I put it very crudely, in Britain we have to learn to grow our own green beans. In Britain, we expect to have fresh green beans on our tables every day of the year, and we expect to draw down Kenya’s water table and exploit its cheap labor so that we can have green beans every day of the year. That has to end. We’ve got to learn to grow our own green beans. We can’t prey upon the assets of others for our own economic well-being.

At the same time, I want to be very clear, I am not a nationalist. I believe it must be possible for a government to respond to its electorate and act in their interests. For me, that’s democracy. At the same time, I don’t believe we can achieve that degree of autonomy without internationalism. We can only do it by actually cooperating. I’m arguing that there must be a much greater emphasis on environmental self-sufficiency. However, that is not nationalism, that is internationalism in my view. That is saying that we want to cooperate with our friends and partners across the world. We don’t want to exploit and extract assets from them. It’s as simple as that.

What always strikes me about the great financial crisis of 2007–9 was that the Left didn’t know it was coming (...) People talked about globalization as if it was a given. And then when it blew up, there was no plan B. We didn’t even know it could happen. We were as stupid as the chair of the Federal Reserve, Alan Greenspan. The Left was as stupid as Greenspan, who said he didn’t believe it could happen.

Meanwhile, Wall Street couldn’t believe its luck because it then consolidated itself and became stronger than it had ever been. Before the financial crisis, it could go bust. Since the financial crisis, no Wall Street bank can go bust anymore."

https://jacobin.com/2026/03/global-financial-system-deindustrialization-climate/

#Deindustrialization #Financialization #ClimateChange #Globalization #Debt #Capitalism

RT @minipetite
Mil objetivos atacados en 24h. Las armas letales autónomas son ilegales pero Irán es la prueba de su realidad. Mi columna de hoy en @elpais habla de la nueva era y su nuevo motto: MOVE FAST & KILL PEOPLE

https://elpais.com/opinion/2026-03-23/muevete-deprisa-y-mata-gente.html

RT @TheHackersNews
🛑 Malicious Trivy images (0.69.4–0.69.6) confirm a supply chain breach using a compromised service account token.

Attackers pushed trojanized builds, spread an npm worm, defaced 44 repos in minutes, and deployed Kubernetes wiper payloads.

🔗 Read → https://thehackernews.com/2026/03/trivy-hack-spreads-infostealer-via.html

This is not the future but rather the present!! ->

"So what exactly is left? Or as Boris Cherny, the head of Claude Code, put it when we met at Anthropic’s headquarters in January: “What is computation — what is coding?” Then he added, “You can get pretty philosophical pretty fast.”

His answer echoed what I’ve heard from pretty much every developer I’ve spoken to: A coder is now more like an architect than a construction worker. Developers using A.I. focus on the overall shape of the software, how its features and facets work together. Because the agents can produce functioning code so quickly, their human overseers can experiment, trying things out to see what works and discarding what doesn’t. Several programmers told me they felt a bit like Steve Jobs, who famously had his staffers churn out prototypes so he could handle lots of them and settle on what felt right. The work of a developer is now more judging than creating.

Cherny himself has been through all the layers of abstraction: As a teenager in California, he taught himself a little Assembly so he could write a program that solved math homework automatically on his calculator. Today he simply pulls out his phone and dictates to Claude what he wants the A.I. agent to do; in a sort of Ouroboric loop, 100 percent of Cherny’s contributions to the Claude codebase are now written entirely by Claude.

While we talked, his phone was sitting on the table in front of us, and at the end of an hour he showed me the screen: 10 Claude agents had been tweaking the codebase. “I haven’t written a single line by hand, and I’m like the most prolific coder on the team,” he said. “It’s an alien intelligence that we’re learning to work with.”"

https://www.nytimes.com/2026/03/12/magazine/ai-coding-programming-jobs-claude-chatgpt.html

#AI #GenerativeAI #LLMs #Programming #SoftwareDevelopment #AIAgents

Sorry, but this is exactly my definition of STATE TERRORISM:

"As the United States and Israel prepared to go to war with Iran, the head of Mossad, Israel’s foreign intelligence service, went to Prime Minister Benjamin Netanyahu with a plan.

Within days of the war’s beginning, said David Barnea, the Mossad chief, his service would likely be able to galvanize the Iranian opposition — igniting riots and other acts of rebellion that could even lead to the collapse of Iran’s government. Mr. Barnea also presented the proposal to senior Trump administration officials during a visit to Washington in mid-January.

Mr. Netanyahu adopted the plan. Despite doubts about its viability among senior American officials and some officials in other Israeli intelligence agencies, both he and President Trump seemed to embrace an optimistic outlook. Killing Iran’s leaders at the outset of the conflict, followed by a series of intelligence operations intended to encourage regime change, they thought, could lead to a mass uprising that might bring about a swift end to the war.

“Take over your government: It will be yours to take,” Mr. Trump told Iranians in his initial address at the war’s start, after saying they should first seek shelter from the bombing.

Three weeks into the war, an Iranian uprising has not yet materialized. American and Israeli intelligence assessments have concluded that the theocratic Iranian government is weakened but intact, and that widespread fear of Iran’s military and police forces has dampened prospects both for nascent rebellion in the country and for ethnic militias outside of Iran to launch cross-border incursions.

The belief that Israel and the United States could help instigate widespread revolt was a foundational flaw in the preparations for a war that has spread across the Middle East...."

https://www.nytimes.com/2026/03/22/us/politics/iran-israel-trump-netanyahu-mossad.html

#Israel #MOSSAD #Iran #StateTerrorism #USA #Trump #War # #Militarism

RT @DropSiteNews
🇮🇶 Iraqi resistance groups agree to a 24-hour ceasefire after a request from the United States and NATO to allow for their withdrawal from Victoria Base in Baghdad, Al Mayadeen reports.

➤ The spokesperson for Saraya Awliya al-Dam resistance faction Abu Mahdi al-Jaafari said Washington and NATO asked Baghdad to secure a pause so forces could withdraw.

➤ Most resistance factions agreed, on the condition that Popular Mobilization Forces (PMF) positions between Samarra and Karbala are not targeted.

➢ “But if you return [to sin], we will return [to punishment]. And We have made Hell a prison for the disbelievers," the spokesman said.

➤ According to al-Jaafari, US troops are now confined to the Kurdistan region, having been pushed out from all other locations by resistance factions.

➤ NATO has now withdrawn all personnel from its mission in Iraq as of Friday, March 20, with several hundred troops from NATO Mission Iraq departing after recent Iranian attacks on Western military bases; spokesperson Allison Hart said the alliance would “adjust its presence” for security reasons, while a source cited by Al Mayadeen said the Italian contingent had fled to Jordan.

https://english.almayadeen.net/news/politics/us-forces-are-now-limited-to-the-kurdistan-region--iraqi-res

RT @HedgieMarkets
🦔 Google is testing AI-generated replacements for headlines and website titles in search results. The Verge noticed their headlines were being rewritten without their input. One example: "I used the 'cheat on everything' AI tool and it didn't help me cheat on anything" became "Cheat on everything AI tool." Google says the goal is to better match titles to user queries and facilitate engagement. They claim if this rolls out widely it won't use generative AI, though they didn't explain what other kind of AI would be rewriting headlines. Google Discover already does this and apparently it "performs well for user satisfaction."

My Take
Google is now rewriting other people's work and putting it in front of users as if that's what the publisher wrote. The headline is part of the article. It's an editorial choice that conveys tone, angle, and intent. When Google changes "Microsoft is rebranding Copilot in the most Microsoft way possible" to "Copilot Changes: Marketing Teams at it Again," they're not clarifying anything, they're replacing the author's voice with generic slop.

The legal question here is interesting. Google has traditionally claimed protection as a platform that indexes and displays content rather than creating it. Once you start rewriting headlines, you're arguably developing content, which gets into Section 230 territory. Publishers whose work gets misrepresented might have defamation claims if an AI-rewritten headline changes the meaning of their article. Google is already driving less traffic to publishers and now they want to edit what little representation those publishers have left in search results. This feels like another step toward a web where Google just tells you what it thinks you should know instead of connecting you to sources.

Hedgie🤗

https://www.theverge.com/tech/896490/google-replace-news-headlines-in-search-canary-coal-mine-experiment

"For years, reviewers said, Microsoft had tried and failed to fully explain how it protects sensitive information in the cloud as it hops from server to server across the digital terrain. Given that and other unknowns, government experts couldn’t vouch for the technology’s security.

Such judgments would be damning for any company seeking to sell its wares to the U.S. government, but it should have been particularly devastating for Microsoft. The tech giant’s products had been at the heart of two major cybersecurity attacks against the U.S. in three years. In one, Russian hackers exploited a weakness to steal sensitive data from a number of federal agencies, including the National Nuclear Security Administration. In the other, Chinese hackers infiltrated the email accounts of a Cabinet member and other senior government officials.

The federal government could be further exposed if it couldn’t verify the cybersecurity of Microsoft’s Government Community Cloud High, a suite of cloud-based services intended to safeguard some of the nation’s most sensitive information.

Yet, in a highly unusual move that still reverberates across Washington, the Federal Risk and Authorization Management Program, or FedRAMP, authorized the product anyway, bestowing what amounts to the federal government’s cybersecurity seal of approval. FedRAMP’s ruling — which included a kind of “buyer beware” notice to any federal agency considering GCC High — helped Microsoft expand a government business empire worth billions of dollars."

https://www.propublica.org/article/microsoft-cloud-fedramp-cybersecurity-government

#Microsoft #FedRAMP #USA #Trump #CyberSecurity #Cloud #CloudComputing

"ProPublica reviewed records of that meeting, providing a rare look at a dramatic shift underway in one of the most sensitive domains of public policy. The Trump administration is upending the way nuclear energy is regulated, driven by a desire to dramatically increase the amount of energy available to power artificial intelligence.

Career experts have been forced out and thousands of pages of regulations are being rewritten at a sprint. A new generation of nuclear energy companies — flush with Silicon Valley cash and boasting strong political connections — wield increasing influence over policy. Figures like Cohen are forcing a “move fast and break things” Silicon Valley ethos on one of the country’s most important regulators.

The Trump administration has been particularly aggressive in its attacks on the Nuclear Regulatory Commission, the bipartisan independent regulator that approves commercial nuclear power plants and monitors their safety. The agency is not a household name. But it’s considered the international gold standard, often influencing safety rules around the world.

The NRC has critics, especially in Silicon Valley, where the often-cautious commission is portrayed as an impediment to innovation. In an early salvo, President Donald Trump fired NRC Commissioner Christopher Hanson last June after Hanson spoke out about the importance of agency independence. It was the first time an NRC commissioner had been fired.

During that Idaho meeting, Cohen shot down any notion of NRC independence in the new era."

https://www.propublica.org/article/trump-nuclear-power-nrc-safety-doge-vought

#USA #Trump #Nuclear #NuclearEnergy #DOGE #NRC #AI #GenerativeAI