doc: apply mobile documentation

Author: jaimecbernardo

.github/ISSUE_TEMPLATE.md

@@ -1,23 +1,29 @@
 <!--
 Thank you for reporting an issue.
 
-This issue tracker is for bugs and issues found within Node.js core.
-If you require more general support please file an issue on our help
-repo. https://github.com/nodejs/help
+This issue tracker is only for reporting bugs and issues found in the nodejs-mobile core library, the nodejs-mobile-cordova plugin or the nodejs-mobile-react-native plugin.
 
+If you are not trying to report a bug or an issue, but rather have a question or are seeking general support, please use the Resources for Newcomers instead:
+https://github.com/janeasystems/nodejs-mobile#resources-for-newcomers
 
-Please fill in as much of the template below as you're able.
+Please fill in as much of the template below as you can.
 
-Version: output of `node -v`
-Platform: output of `uname -a` (UNIX), or version and 32 or 64-bit (Windows)
-Subsystem: if known, please specify affected core module name
+Project: nodejs-mobile, nodejs-mobile-cordova or nodejs-mobile-react-native
+Version: the version of the library or plugin you are using
+Mobile device: the device manufacturer and model or the simulator/emulator used
+Mobile OS and version: Android or iOS version
+Development Node.js: output of `node -v` on the machine used to build the application
+Development platform: output of `uname -a` (UNIX), or version and 32 or 64-bit (Windows)
 
-If possible, please provide code that demonstrates the problem, keeping it as
-simple and free of external dependencies as you are able.
+If possible, please provide code that demonstrates the problem, keeping it as simple and free of external dependencies as possible. Cloning and adapting one of the samples to show the issue is a simple way to achieve this:
+https://github.com/janeasystems/nodejs-mobile-samples/
 -->
 
+* **Project**:
 * **Version**:
-* **Platform**:
-* **Subsystem**:
+* **Mobile device**:
+* **Mobile OS and version**:
+* **Development Node.js**:
+* **Development platform**:
 
 <!-- Enter your issue details below this comment. -->

.github/ISSUE_TEMPLATE/1-bug-report.md

@@ -14,31 +14,3 @@ Contributors guide: https://github.com/nodejs/node/blob/master/CONTRIBUTING.md
 - [ ] tests and/or benchmarks are included
 - [ ] documentation is changed or added
 - [ ] commit message follows [commit guidelines](https://github.com/nodejs/node/blob/master/doc/guides/contributing/pull-requests.md#commit-message-guidelines)
-
-<!--
-Developer's Certificate of Origin 1.1
-
-By making a contribution to this project, I certify that:
-
-(a) The contribution was created in whole or in part by me and I
-    have the right to submit it under the open source license
-    indicated in the file; or
-
-(b) The contribution is based upon previous work that, to the best
-    of my knowledge, is covered under an appropriate open source
-    license and I have the right under that license to submit that
-    work with modifications, whether created in whole or in part
-    by me, under the same open source license (unless I am
-    permitted to submit under a different license), as indicated
-    in the file; or
-
-(c) The contribution was provided directly to me by some other
-    person who certified (a), (b) or (c) and I have not modified
-    it.
-
-(d) I understand and agree that this project and the contribution
-    are public and that a record of the contribution (including all
-    personal information I submit with it, including my sign-off) is
-    maintained indefinitely and may be redistributed consistent with
-    this project or the open source license(s) involved.
--->

.github/ISSUE_TEMPLATE/2-feature-request.md

@@ -0,0 +1,49 @@
+# Frequently Asked Questions
+
+- [Can I use npm node-modules with nodejs-mobile?](#can-i-use-npm-node-modules-with-nodejs-mobile)
+- [Are all Node.js APIs supported on mobile?](#are-all-nodejs-apis-supported-on-mobile)
+- [Trying to write a file results in an error. What's going on?](#trying-to-write-a-file-results-in-an-error-whats-going-on)
+- [Are Node.js native modules supported?](#are-nodejs-native-modules-supported)
+- [How can I improve Node.js load times?](#how-can-i-improve-nodejs-load-times)
+- [Can I run two or more Node.js instances?](#can-i-run-two-or-more-nodejs-instances)
+- [Can I run Node.js code in a WebView?](#can-i-run-nodejs-code-in-a-webview)
+- [Can you support a plugin for the X mobile framework?](#can-you-support-a-plugin-for-the-x-mobile-framework)
+
+## Can I use npm node-modules with nodejs-mobile?
+
+npm modules can be used with nodejs-mobile. They need to be installed at development time in the application source folder that contains the Node.js project files. There are samples that show how to use npm modules for [Android](https://github.com/janeasystems/nodejs-mobile-samples/tree/master/android/native-gradle-node-folder) and [iOS](https://github.com/janeasystems/nodejs-mobile-samples/tree/master/ios/native-xcode-node-folder) when using the native library directly. There are instructions in the [nodejs-mobile-cordova](https://github.com/janeasystems/nodejs-mobile-cordova#node-modules) and [nodejs-mobile-react-native](https://github.com/janeasystems/nodejs-mobile-react-native#node-modules) plugins README on how to use them.
+
+## Are all Node.js APIs supported on mobile?
+
+Not every API is supported on mobile, the main reason for this being that the mobile operating systems won't allow applications to call certain APIs that are expected to be available on other operating systems. Examples:
+- APIs that create new processes, such as `child_process.spawn()` or `child_process.fork()` will run into permission issues.
+- Using `process.exit()` is not allowed by the Apple App Store guildelines.
+- `os.cpus()` may return inconsistent/unreliable results, since different OS versions will have different permissions for accessing CPU information.
+
+## Trying to write a file results in an error. What's going on?
+
+Mobile platforms are different than the usual desktop platforms in that they require applications to write in specific sandboxed paths and don't have permissions to write elsewhere. You should pass an appropriate writable path for your use case to the Node.js runtime and write there. An API call to return the path most regularly used for data in each platform has been added to the [nodejs-mobile-cordova](https://github.com/janeasystems/nodejs-mobile-cordova#cordovaappdatadir) and [nodejs-mobile-react-native](https://github.com/janeasystems/nodejs-mobile-react-native#rn_bridgeappdatadir) plugins.
+
+## Are Node.js native modules supported?
+
+Node native modules, which contain native code, are able to run on nodejs-mobile, as long as they can be cross-compiled for the target platform / CPU. The cross-compiling feature is integrated into the plugins and instructions can be found in the [nodejs-mobile-cordova](https://github.com/janeasystems/nodejs-mobile-cordova#native-modules) or in the [nodejs-mobile-react-native](https://github.com/janeasystems/nodejs-mobile-react-native#native-modules) README, but only Linux and MacOS development machines are currently supported. Modules that contain custom build steps and platform specific code may need workarounds/changes to get them to work. We've created a github repository so that the workarounds/changes can be discussed and shared: https://github.com/janeasystems/nodejs-mobile-module-compat
+
+## How can I improve Node.js load times?
+
+Applications that contain a large number of files in the Node.js project can have their load times decreased by reducing the number of files. While installing npm modules, these can be installed with the `--production` flag, so that modules that are used for development only are not included in your project, e.g.: `npm install --production <module_name>`. Using tools that merge all nodejs project files into a bundle, such as [`noderify`](https://www.npmjs.com/package/noderify) and using the bundle instead has been observed to improve load times in most situations.
+
+## Can I run two or more Node.js instances?
+
+No. The runtime expects to be run as a single instance in the process. In practice this should not preclude any usage scenarios, given node's asynchronous nature. Multiple sub-tasks can be executed by simply loading all the corresponding modules with `require` from a main script.
+
+## Can I run Node.js code in a WebView?
+
+No. Node.js uses a libuv event loop at its core, which is different than the event loop in the WebView. Having the node runtime run in its own thread also prevents Node.js tasks for interfering with the UI, which might cause responsiveness issues.
+The supported usage scenario is that nodejs-mobile runs in a background thread and the UI (in this case a WebView) must use a communication mechanism to send/receive data from Node.js.
+This technique is used in the `nodejs-mobile-cordova` plugin, where Cordova uses a dedicated thread to run Node.js alongside the WebView.
+
+## Can you support a plugin for the X mobile framework?
+
+We are currently focused on supporting cordova and react-native plugins only, but we are open to community contributions for other frameworks.
+If you are interested in a particular framework, please see if [an issue](https://github.com/janeasystems/nodejs-mobile/issues/) for it has already been opened, and let us know about your interest in there. Otherwise, feel free to open a new issue.
+