How to report issues with browserify

How to report issues with browserify

isolate

Attempt to isolate the source of your problem to browserify. This will help you confirm that the problem is with browserify and help you prepare the example code you'll need to submit to demonstrate it.

search

Make a reasonable attempt to search open and closed issues and pull requests to see if the problem has already been reported, especially if you're not using the latest version of browserify.

example

Create a minimal test case. This should contain the minimal amount of code and information necessary to reproduce the problem. At minimum it should generally include: 1. The version of browserify you're using 2. The API call or CLI command you're using to invoke browserify.

You should exclude layers of complexity over browserify, like gulp or grunt code, unless it's necessary to demonstrate the problem (and it still suggests a problem with browserify itself). If you must include that sort of thing, narrow it down to the relevant parts as much as possible. Don't paste a whole gulpfile with a bunch of tasks unrelated to the browserify issue.

Browserify API or CLI commands are preferable. Make those as minimal as possible while demonstrating the problem. In other words, exclude any options or commands that aren't necessary to reproduce the problem.

It may be necessary to include some information about your file system, such as the location and contents of files you're giving as input to browserify. Again, try to show the fewest, most minimal example files that will demonstrate the problem.

markup

Mark up code in your issue report. There are 2 primary ways of doing this in GitHub issues:

1. Enclose inline code in backticks (`). This is appropriate for things like variable and file names.

2. Enclose blocks of code in pairs of triple backticks, like:

    ```
    // code here
    ```
   

You can include a language identifier to enable language-specific syntax highlighting, like js indicates JavaScript in this example:

  ```js
  // code here
  ```

See the following for more information about formatting messages on GitHub:

• Writing on GitHub / Markdown Basics
• Writing on GitHub / GitHub Flavored Markdown

preview

Use the preview feature to make sure your post looks good (code formatting, etc.) before submitting.