Updated docs and issue templates for new FAQs

.github/ISSUE_TEMPLATE.md

@@ -1,5 +1,9 @@
 <!-- *Before creating an issue please make sure you are using the latest version of mongoose -->
 
+<!-- *Getting a `Operaion ... timed out after 10000ms` error? Read this FAQ entry: https://mongoosejs.com/docs/faq.html#operation-buffering-timed-out -->
+
+<!-- *Getting a `x.$__y is not a function` error? Read this FAQ entry: https://mongoosejs.com/docs/faq.html#not-a-function -->
+
 **Do you want to request a *feature* or report a *bug*?**
 
 **What is the current behavior?**

docs/faq.md

@@ -12,6 +12,48 @@ hr {
 }
 </style>
 
+<hr id="operation-buffering-timed-out" />
+
+<a class="anchor" href="#operation-buffering-timed-out">**Q**</a>. Operation `...` timed out after 10000 ms. What gives?
+
+**A**. At its core, this issue stems from not connecting to MongoDB.
+You can use Mongoose before connecting to MongoDB, but you must connect at some point. For example:
+
+```javascript
+await mongoose.createConnection(mongodbUri);
+
+const Test = mongoose.model('Test', schema);
+
+await Test.findOne(); // Will throw "Operation timed out" error because didn't call `mongoose.connect()`
+```
+
+```javascript
+await mongoose.connect(mongodbUri);
+
+const db = mongoose.createConnection();
+
+const Test = db.model('Test', schema);
+
+await Test.findOne(); // Will throw "Operation timed out" error because `db` isn't connected to MongoDB
+```
+
+If you are using an application, like a bot, that wishes to connect to Mongoose, you must ensure that you are connecting before the bot activates.
+For example, when working with discord bots, the last line of your index file is `client.login(token)`.
+You want to place the connection string, `mongoose.connect().then()` before this line.
+Do not place it in an event handler like `client.on('message')`, as this activates after you have logged in to the bot.
+
+<a class="anchor" href="#not-local"> **Q**</a>. I am able to connect locally but when I try to connect to MongoDB Atlas I get this error. What gives?
+
+You must ensure that you have whitelisted your ip on [mongodb](https://docs.atlas.mongodb.com/security/ip-access-list/) to let it connect.
+You can allow access from all ips with `0.0.0.0/0`.
+
+<hr id="not-a-function" />
+
+<a class="anchor" href="#not-a-function">**Q**</a>. x.$__y is not a function. What gives?
+
+**A**. This issue is a result of having multiple versions of mongoose installed that are incompatible with each other. Run `npm list | grep "mongoose"` to
+find and remedy the problem.
+
 <hr id="unique-doesnt-work" />
 
 <a class="anchor" href="#unique-doesnt-work">**Q**</a>. I declared a schema property as `unique` but I can still save duplicates. What gives?