• 5 Posts
  • 95 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.









  • It doesn’t say what they’re planning to do about laws requiring age verification. It says they’re forming a group to figure that out. The problem with bad legislation is you can’t just ignore it, so they need to at least work out an approach. In itself this news is neutral, but we’ll have to see what they decide.