Create a troubleshooting guide

[xzyfer]

This PR introduces a basic troubleshooting guide for common issues.

This will give us a common places to link people to from issues, and single point of reference for debugging information.

I don't by any means expect this to be perfect right off the bat, but we need start somewhere.

Fixes #916.

/cc @am11 @saper

[am11]

👍

Note that @piscisaureus particularly tested the delay-load hook solution with node-sass nodejs/node#1251 (comment) and I can confirm with that io.js process works with node prefix and there is no module did not self-register error with node-sass anymore; given we build node-sass binary for Windows with the distilled node-gyp dependency under io.js repo.

With that said: to turn on delay-load-hook, use:

{
  'targets': [
    {
      'target_name': 'binding',
      'win_delay_load_hook': 'true',
      ...

in binding.gyp.

Also, the same solution is merged in original node-gyp repo: nodejs/node-gyp#599, but the real caveat is that node-gyp is yet to bring io.js support: nodejs/node-gyp#564.

[xzyfer]

I admit to only having a passing familiarity with the issue. Would
appreciate a PR to clarify the doc.
On 3 May 2015 18:22, "Adeel Mujahid" notifications@github.com wrote:

[image: 👍]

Note that @piscisaureus https://github.com/piscisaureus particularly
tested the delay-load hook solution with node-sass nodejs/node#1251
(comment) nodejs/node#1251 (comment)
and I can confirm with that io.js process works with node prefix and
there is no module did not self-register error with node-sass anymore;
given we build node-sass binary for Windows with the distilled node-gyp
dependency
https://github.com/iojs/io.js/tree/master/deps/npm/node_modules/node-gyp
under io.js repo.

With that said: to turn on delay-load-hook, use:

{
'targets': [
{
'target_name': 'binding',
'win_delay_load_hook': 'true',
...

in binding.gyp.

Also, the same solution is merged in original node-gyp repo:
nodejs/node-gyp#599
nodejs/node-gyp#599, but the real caveat
is that node-gyp is yet to bring io.js support: nodejs/node-gyp#564
nodejs/node-gyp#564.

—
Reply to this email directly or view it on GitHub
#921 (comment).