News for hackers. Stuff that matters.
Re:10x Editor by czx4f4bd on Tuesday January 03, 2023 @08:17PM (#34240601)
The only one that's stuck with me is https://github.com/microsoft/pyright, mainly because I thought it was strange that Microsoft would publish something such a lackluster README. It's not the worst ever, but it lacks a clear sales pitch and a concise explanation of why you'd use it instead of mypy. If you go in without that added context, it's kind of mystifying why it even exists or why you'd use it compared with the alternatives.
Re:10x Editor by _kst_ on Tuesday January 03, 2023 @10:55PM (#34241817)
That's not quite the kind of thing I'm referring to. The first full sentence of the README tells you what it is: "Pyright is a fast type checker meant for large Python source bases."

I'm referring to READMEs that provide no useful information unless you've already been using previous versions of the product (information that should probably go into a file named something like "Changes").

(And again, I don't have a good example.)