Hacker News Reader

Comment by preya2k | Hacker News Reader

Spent about two minutes on the website and could not find out what "userscript support for browsers" means. Literally could not figure out, what this thing does – and I have a degree in CS. Maybe it's just me who's not in the know, but I think that's something a documentation/website should always deliver: a high level description for out-of-domain people explaining what a piece of software does.

View on HN

How far down the stack does that requirement go, though? Anybody who knows what a userscript is will know why they need a userscript manager and anybody who doesn't won't need one. The homepages for Firefox and Chrome don't explain what a browser does, nor what the WWW is, or a webpage, etc, etc

Good question. Very debatable.

I don't agree with your statement that "anybody who doesn't [know what a userscript is] won't need one". If it was explained better there might definitely be people who could use this and become interested in this, without knowing its name before.

One level up/down is a good way to reach people who don't yet know but are ready to learn.

> anybody who doesn't won't need one

This might be the first time some people hears about userscripts. It is certainly possible to have been an internet user for many years without hearing about them. Does not mean they would not be useful to a subset of such persons.

Also [1].

[1] https://xkcd.com/1053/

I suspect the target demographic already knows what a userscript is.

https://en.m.wikipedia.org/wiki/Userscript

It's hard to explain. Browse through to see lists of userscript

https://userscripts-mirror.org/

https://openuserjs.org/

You might have missed this at the bottom of the page:

> Contribution

> You are absolutely welcome to contribute code to GitHub.

> You are welcome to help with this website too. Documents, improvements, articles about Violentmonkey, etc.

Maybe you need a master's on Google: https://www.google.com/search?client=firefox-b-e&q=userscrip...

That's not what I'm trying to say. Obviously I can google this. I still think documentation should say within a couple of words what a piece of software does – without having a lot of domain knowledge.

Reply on news.ycombinator.com