Improve docs

README.md

@@ -1,19 +1,31 @@
 # clockwerk
 
-[![Coverage Status](https://coveralls.io/repos/github/onatm/clockwerk/badge.svg?branch=master)](https://coveralls.io/github/onatm/clockwerk?branch=master)
+[![Coverage Status](https://coveralls.io/repos/github/onatm/clockwerk/badge.svg?branch=main)](https://coveralls.io/github/onatm/clockwerk?branch=main)
 [![Go Report Card](https://goreportcard.com/badge/github.com/onatm/clockwerk)](https://goreportcard.com/report/github.com/onatm/clockwerk)
 [![GoDoc](http://godoc.org/github.com/onatm/clockwerk?status.png)](http://godoc.org/github.com/onatm/clockwerk) 
 
 Job Scheduling Library
 
 clockwerk allows you to schedule periodic jobs using a simple, fluent syntax.
 
-## Usage
+## Installing
+
+Using clockwerk is easy. First, use `go get` to install the latest version of the library.
 
 ``` sh
-go get github.com/onatm/clockwerk
+go get -u github.com/onatm/clockwerk@latest
+```
+
+## Usage
+
+Include clockwerk in your application:
+
+```go
+import "github.com/onatm/clockwerk"
 ```
 
+## Example
+
 ``` go
 package main
 

doc.go

@@ -1,25 +1,24 @@
 /*
 Package clockwerk implements an in-process scheduler for periodic jobs.
 
-Usage
+# Usage
 
 Callers may register Jobs to be invoked on a given schedule. Clockwerk will run
 them in their own goroutines.
 
-  type DummyJob struct{}
-
-  func (d DummyJob) Run() {
-    fmt.Println("Every 30 seconds")
-  }
-  ...
-  var job DummyJob
-  c := clockwerk.New()
-  c.Every(30 * time.Second).Do(job)
-  c.Start()
-  ...
-  // Funcs are invoked in their own goroutine, asynchronously.
-  ...
-  c.Stop()  // Stop the scheduler (does not stop any jobs already running).
+	type DummyJob struct{}
 
+	func (d DummyJob) Run() {
+	  fmt.Println("Every 30 seconds")
+	}
+	...
+	var job DummyJob
+	c := clockwerk.New()
+	c.Every(30 * time.Second).Do(job)
+	c.Start()
+	...
+	// Funcs are invoked in their own goroutine, asynchronously.
+	...
+	c.Stop()  // Stop the scheduler (does not stop any jobs already running).
 */
 package clockwerk