> If you're reading this you probably have some idea of what slate is.
Tip for anyone writing technical/product blogs: never assume readers know what your product is. They probably came in for the first time from a random link on some site like HN and this is your first (and maybe only) opportunity to get that elevator pitch in. I think this particular example is a good one, in that they immediately provide a one-sentence "refresher" that gives the rest of the post some context.
Might be also worthwhile considering a more memorable/distinctive name, unless of course this is only aimed at those who are actively and aggressively following developments in that space. The post piqued my interest enough to make me vaguely think, hmmm, I might follow that up some time in the future when I'm less busy however if I fail to bookmark it and assuming the name 'slate' loosely sticks in my head, then a Google search for 'slate', 'slate ai' or even 'slate ai agent' isn't going to bring me back to this product again.
I cannot find any link to a repository with that ported library. I can't imagine why you wouldn't share this exciting port, unless of course the code is not that great?
And as a sidenote, why would you ever hijack the up/down cursor keys on a web page? There are still people out there on actual computers which use them for scrolling.
> And as a sidenote, why would you ever hijack the up/down cursor keys on a web page? There are still people out there on actual computers which use them for scrolling.
There are also people who will give up on the article when they realize they can't scroll with the arrow keys.
9 comments
[ 3.9 ms ] story [ 40.0 ms ] threadTip for anyone writing technical/product blogs: never assume readers know what your product is. They probably came in for the first time from a random link on some site like HN and this is your first (and maybe only) opportunity to get that elevator pitch in. I think this particular example is a good one, in that they immediately provide a one-sentence "refresher" that gives the rest of the post some context.
Might be also worthwhile considering a more memorable/distinctive name, unless of course this is only aimed at those who are actively and aggressively following developments in that space. The post piqued my interest enough to make me vaguely think, hmmm, I might follow that up some time in the future when I'm less busy however if I fail to bookmark it and assuming the name 'slate' loosely sticks in my head, then a Google search for 'slate', 'slate ai' or even 'slate ai agent' isn't going to bring me back to this product again.
Yeah, they make audio plugins. :)
Its javascript to typescript, which unless I'm missing something, can be done with `mv foo.js foo.ts`. No examples of any transforms done by the tool.
And it wasn't one sentence, it was a sequence of questions and answers.
I guess they started with the title for the blog post and didn't really worry about showing whether it did anything useful or not.
And as a sidenote, why would you ever hijack the up/down cursor keys on a web page? There are still people out there on actual computers which use them for scrolling.
There are also people who will give up on the article when they realize they can't scroll with the arrow keys.