

It’s not easy, particularly if you developed it and have spent months immersed in all the detail. To emerge from that and imagine coming to it as a new user is pretty hard. I don’t have much to add but I like your advice. I need to rewrite the docs for one of my projects and I’ll be bearing your points in mind.
Maybe one other point I’d add is: have a clear idea of who you’re writing for, and have different levels and styles of documentation for different types of users. Don’t try to satisfy everyone in the same document. Divide the documentation up by intended readership.


From the CNN article:
In Tehran province, strikes have affected 275 pharmaceutical, health and emergency centers, 498 schools and 17 Red Crescent centers, Islamic Republic News Agency (IRNA) said, citing Pir Hossein Kolivand, head of Iran’s Red Crescent society.
The Al Jazeera link has the same number:
The damaged structures include 62,000 homes, 281 medical centres, hospitals and pharmacies. Additionally, 498 schools had been damaged, as well as 17 rescue points and 12 rescue vehicles.


It’s being fairly widely reported, though most sites seem to say 498 schools damaged, not 600. CNN, for example, or Al Jazeera. The source is a statement by the head of Iran’s Red Crescent Society, Pirossein Kholivand. Here’s an Iranian news agency giving more details of his statement. Of course, we need to bring media literacy to this and remember that truth is especially hard to discern in wartime.


I guess you’re not waiting on an MRI.


Trump’s tariffs on the whole world are also effectively self-imposed sanctions on the USA.


Hey, they believe in extremist terrorist stuff like investing in public services for the good of everyone. Clearly these people are crazy and dangerous.*
*to the wealth and power of billionaires.


Trump is a useful idiot for everyone except the USA.


Autonomous cars will need 300 gigabytes of DRAM or more
So regular cars won’t. OK.


It is often understood as a vision of territorial expansion to encompass Palestine, Lebanon and Jordan, along with significant parts of Syria, Iraq, Egypt and Saudi Arabia.
When ideas like this are popular, no wonder Israel is not much loved in the region. Even apart from the constant violence abroad and genocide at home.


I feel like we’re slowly discovering that the UK is still in fact run by Tony Blair.


Surely Keir Starmer wouldn’t tell a lie.


What the fuck is wrong with the UK these days? It used to be a pretty open-minded place, but now it’s rocketing backwards. Is it just a race to beat Nigel Farage to full-on fascism?


Netanyahu has been lying that Iran is weeks away from having functional nukes since at least 1995:


The real narrative may have just been that Netanyahu has always wanted to destroy Iran and Trump was stupid and vain enough to be persuaded to do it for him. Since Trump can’t admit a mistake, he has to double down.


It’s also something they claimed to have achieved last year when they bombed Iran.


Also, they boasted that their bombing of Iran last year had completely destroyed Iran’s nuclear program. And the experts say there never even was an Iranian nuclear bomb program worth the name.


Krasnov has proven to be well worth the investment.


They’re following Israel’s approach: bomb civilian infrastructure including schools, hospitals, water treatment plants and other things that give civilians any quality of life. Also kill many civilians to make the lives of others as miserable and fragile as possible. It’s all war crimes but it’s what they did in Gaza.
I think the Pope was responding to this:
Pete Hegseth prays for violence ‘against those who deserve no mercy’ while hosting first Christian service