Improved documentation

Author: msavin

DOCUMENTATION.md

@@ -16,6 +16,39 @@ Steve Jobs is an all inclusive package for scheduling background jobs. It automa
  - [Jobs.remove](#jobsremove)
  - [Jobs.collection](#jobscollection)
 
+
+### Overview of a Job Document
+
+Every Job document in stored into MongoDB because MongoDB has great persistence and querying features, and because you would not be required to set up any additional services to get running.
+
+Here is an example of what a jobs document looks like:
+
+```js
+{
+	_id: "riEauLYngjSGoETWh",
+	name: "sendEmail",
+	created: 2019-01-13T14:24:42.444Z,
+	serverId: "R7KPMHWz7DEsDWBCm",
+	state: "success",
+	due: 2019-01-13T14:24:51.444Z,
+	priority: 0,
+	arguments: ["sendReminder", "[email protected]", "The future is here!"],
+	history: [{
+  		date: 2019-01-13T14:24:51.444Z,,
+		state: "success",
+		serverId: "R7KPMHWz7DEsDWBCm" 
+	}, {
+		date: 2019-01-13T14:23:51.444Z,
+		type: "reschedule",
+		serverId: "5whJ8rWzDcTv8aZGy",
+		newDue: 2019-01-13T14:24:51.444Z
+	}] 
+}
+```
+
+The history of each job is kept in the `history` field, which can also hold the result of the job, if you pass it into the `success` or `failure` action.
+
+
 ### Jobs.configure
 
 `Jobs.configure` allows you to configure how the package should work. You can figure one option or all of them. All the options are pre-configured in [`./package/server/imports/utilities/config.js`](https://github.com/msavin/SteveJobs..meteor.jobs.scheduler.queue.background.tasks/blob/master/package/server/imports/utilities/config/index.js). 

README.md

@@ -41,15 +41,17 @@ Then, write your background jobs like you would write your methods:
 ```javascript
 Jobs.register({
     "sendReminder": function (to, message) {
+        var instance = this;
+
         var call = HTTP.put("http://www.magic.com/sendEmail", {
             to: to,
             message: message
         })
 
         if (call.statusCode === 200) {
-            this.success(call.result);
+            instance.success(call.result);
         } else {
-            this.reschedule({
+            instance.reschedule({
                 in: {
                     minutes: 5
                 }
@@ -82,6 +84,47 @@ Jobs.run("sendReminder", "[email protected]", "The future is here!", {
 
 The configuration object supports `date`, `in`, `on`, `priority`, `singular`, `unique`, and `data`, all of which are completely optional. For more information, see the `Jobs.run` <a href="https://github.com/msavin/SteveJobs..meteor.jobs.scheduler.queue.background.tasks/blob/master/DOCUMENTATION.md#jobsrun">documentation</a>.
 
+## Repeating Jobs
+
+Creating repeating jobs is easy, and you have total control over how they run. First, you need to create a job that will automatically replicate itself.
+
+```javascript
+Jobs.register({
+    "syncData": function () {
+        var instance = this;
+
+        var call = HTTP.put("http://www.magic.com/syncData")
+
+        if (call.statusCode === 200) {
+            instance.replicate({
+                in: {
+                    hours: 1
+                }
+            });
+            
+            // alternatively, you can use instance.remove to save storage
+            instance.success(call.result);
+        } else {
+            instance.reschedule({
+                in: {
+                    minutes: 5
+                }
+            });
+        }
+    }
+});
+```
+
+Then, schedule the job to run with the `singular` flag, only if an instance of it does not exist.
+
+```javascript
+Meteor.startup(function () {
+    Jobs.run("syncData", {
+        singular: true
+    })    
+})
+```
+
 ## Documentation
 
 `Jobs.register` and `Jobs.run` are all you need to get started, but that's only the beginning of what the package can do. To explore the rest of the functionality, jump into the documentation: