I'd like to write some documentation for the NJOBS feature in libexec/build-libv8

[bretweinraub]

Usually when I find a useful feature in the code I like to surface this to the documentation.

Specifically this:

https://github.com/rubyjs/libv8-node/blob/master/libexec/build-libv8#L11-L12

I'm happy to write the docs, where should I put them?

README.md doesn't seem to include much about the "guts".... but I'm happy to put it there.

I wonder what the document structure should be. A proposal:

Technical Details

Build Issues

Improving Built Times Using Parallel Compile Jobs

That's just an example.....

[lloeki]

I'm happy to write the docs, where should I put them?

README.md doesn't seem to include much about the "guts".... but I'm happy to put it there.

README is fine. As is, the script should be able to detect the number of hardware cores available properly on all unix OSes (linux, darwin, freebsd, solaris) without a third-party tool, and use that as a default for NJOBS.