News for hackers. Stuff that matters.
Re:Generate your document site in 3 seconds by snazz on Sunday January 13, 2019 @01:13PM (#18897853)
It’s funny that this README just assumes you have Node installed. Not having ever used it before, I had no idea what “npx” was or did. A “requirements” or “dependencies” section on the homepage would be nice, as would a comparison to other static site generators.
Re:Generate your document site in 3 seconds by giancarlostoro on Sunday January 13, 2019 @03:21PM (#18898454)
Hell I have node and I don't even know what npx is. There should be a PEP8 for readme's. Can a 5 year old figure out your README? or something close to that extent. Otherwise their README is fine.
Re:Generate your document site in 3 seconds by karolg on Sunday January 13, 2019 @04:25PM (#18898792)
It is explained in the next paragraph what "npx" is:

> Yep. cool? “npx” allows you to run a temporary package, which will be deleted right after each use. Use this command to try and experience how Fine works. Doesn’t hurt to try, huh?

Re:Generate your document site in 3 seconds by ljm on Sunday January 13, 2019 @05:30PM (#18899127)
It's not a satisfactory explanation for the layman, because it still assumes that you know that a package refers to something on npm, and that npx itself is a part of Node/npm.

All it would really need to say is that it requires a recent version of Node.

Re:Generate your document site in 3 seconds by kpgraham on Sunday January 13, 2019 @02:07PM (#18898123)
Thanks. I have need something like this, but the web pages do not indicate anything about what it does, how it works or how to use it. I don't have Node installed, either, so it was a waste of time clicking through. I wonder why it was posted here?
Re:Generate your document site in 3 seconds by allover on Sunday January 13, 2019 @02:53PM (#18898323)
It’s not that well written but ‘why was it posted’ because it doesn’t introduce npx is a bit much.

It’s also easily put together by the next example (uses npm) and google, if you were actually interested in the subject.

Re:Generate your document site in 3 seconds by paulddraper on Sunday January 13, 2019 @06:43PM (#18899466)
I see tons of Rust CLI projects with precious little about their requirements.

Sure, a not complete README is nice, but not having one is not exactly weird.