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)?
[ Parent
| on HN ]
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.