• 259 Posts
  • 571 Comments
Joined 3 years ago
cake
Cake day: June 16th, 2023

help-circle




  • 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.