3 ms·
It took WAY too many hops to figure out what this thing even is. I assume that they're going for a very specific audience (i.e. people who regularly write SQLi
by StevePerkins 3y ago
It took WAY too many hops to figure out what this thing even is.
I assume that they're going for a very specific audience (i.e. people who regularly write SQLite extensions in C code). And don't have much interest in reading a broader audience, of people who don't currently write SQLite extensions but might find it valuable if made more accessible.
A tech tool should have SOME code snippet on the main page, giving some idea of context at an immediate glance. This isn't hard. Don't have your main page be a YouTube video introducing other YouTube videos, and your "Docs" section contain zero code because that's actually tucked away somewhere else.
- hinkley 3y ago> It took WAY too many hops to figure out what this thing even is. This is why I'm never done with documentation until I've watched at least two users try to do something productive with it. I'm very sensitive to the idea of circular reasoning. I still do it without noticing, and I'm someone who cares. People who don't care at all are much worse. Feeling sympathy for an imaginary person in your head will never work as well as feeling sympathy for an actual struggling human.