News for hackers. Stuff that matters.
Re:Show HN: My Go SQLite driver did poorly on a benchmark, s... by KingOfCoders on Friday December 15, 2023 @01:11AM (#38651500)
I think when you create a website (write a document, write a README) it is important to imagine the top 3 reader/visitor personas. What do they want from the README (website)?

  1. Go+SQLite user: No CGO
  2. Go user
  3. Wanting to use the library
  4. Someone following a link from HN
  5. ...
Re:Show HN: My Go SQLite driver did poorly on a benchmark, s... by carbocation on Friday December 15, 2023 @01:18AM (#38651532)
Agreed, although I think a brief one-line intro to what this thing does wouldn't really interrupt the flow for any of the above use-cases. Right now, the top of the README is a list of sub-libraries, listing the library first.

Personally, I would add ~2 sentences in the order I outlined, and then I would reorient the list (currently library-first) in a use-case first arrangement like you mentioned.

I mean, realistically my git repos are a mess, so who am I to talk? But this one looks promising enough such that it's worth offering a bit of feedback.

Re:Show HN: My Go SQLite driver did poorly on a benchmark, s... by KingOfCoders on Friday December 15, 2023 @02:59AM (#38652030)
Agree,

4. Someone following a link from HN

I'm often confused when clicking through from HN and can't figure out from the website or README what the project is doing.

Re:Show HN: My Go SQLite driver did poorly on a benchmark, s... by ncruces on Friday December 15, 2023 @05:46AM (#38652880)
Thank you for the feedback! I tried to improve the copy a bit, but this is clearly not my thing…
Re:Show HN: My Go SQLite driver did poorly on a benchmark, s... by trevyn on Friday December 15, 2023 @04:50AM (#38652595)
Sometimes you want people who don’t get it to bounce.

Keeps the signal to noise ratio higher.