diff --git a/Makefile b/Makefile
index 71ee7bf..4ba6f8b 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,11 @@
README:
- godoc2md github.com/eduncan911/podcast > README.md.tmp
- echo "[](https://godoc.org/github.com/eduncan911/podcast) [](https://travis-ci.org/eduncan911/podcast) [](https://coveralls.io/github/eduncan911/podcast?branch=master) [](https://goreportcard.com/report/github.com/eduncan911/podcast)" > README.md
+ godoc2ghmd github.com/eduncan911/podcast > README.md.tmp
+ echo "[](https://godoc.org/github.com/eduncan911/podcast)" > README.md
+ echo "[](https://travis-ci.org/eduncan911/podcast)" >> README.md
+ echo "[](https://coveralls.io/github/eduncan911/podcast?branch=master)" >> README.md
+ echo "[](https://goreportcard.com/report/github.com/eduncan911/podcast)" >> README.md
+ echo "[](https://godoc.org/github.com/eduncan911/podcast)"
+ echo "[](https://eduncan911.mit-license.org/)" >> README.md
+ echo >>README.md
cat README.md.tmp >> README.md
rm README.md.tmp
diff --git a/README.md b/README.md
index f47c568..ab633b5 100644
--- a/README.md
+++ b/README.md
@@ -1,34 +1,31 @@
-[](https://godoc.org/github.com/eduncan911/podcast) [](https://travis-ci.org/eduncan911/podcast) [](https://coveralls.io/github/eduncan911/podcast?branch=master) [](https://goreportcard.com/report/github.com/eduncan911/podcast)
-
+[](https://godoc.org/github.com/eduncan911/podcast)
+[](https://travis-ci.org/eduncan911/podcast)
+[](https://coveralls.io/github/eduncan911/podcast?branch=master)
+[](https://goreportcard.com/report/github.com/eduncan911/podcast)
+[](https://eduncan911.mit-license.org/)
# podcast
-`import "github.com/eduncan911/podcast"`
-
-* [Overview](#pkg-overview)
-* [Index](#pkg-index)
-* [Examples](#pkg-examples)
-* [Subdirectories](#pkg-subdirectories)
-
-## Overview
-Package podcast is an iTunes and RSS 2.0 podcast generator for GoLang that
-enforces strict compliance by using its simple interface.
+Package podcast generates a fully compliant iTunes and RSS 2.0 podcast feed
+for GoLang using a simple API.
Full documentation with detailed examples located at https://godoc.org/github.com/eduncan911/podcast
-Usage
-
+### Usage
+To use, `go get` and `import` the package like your typical GoLang library.
$ go get -u github.com/eduncan911/podcast
+
+ import "github.com/eduncan911/podcast"
The API exposes a number of method receivers on structs that implements the
logic required to comply with the specifications and ensure a compliant feed.
A number of overrides occur to help with iTunes visibility of your episodes.
-Notably, the [Podcast.AddItem(i Item)](#Podcast.AddItem) function performs most of the
-heavy lifting by taking the [Item](#Item) input and performing validation, overrides
-and duplicate setters through the feed.
+Notably, the [Podcast.AddItem(i Item)](#Podcast.AddItem) function performs most
+of the heavy lifting by taking the [Item](#Item) input and performing
+validation, overrides and duplicate setters through the feed.
-See the detailed Examples in the GoDocs for complete usage.
+See the detailed Examples of the API at https://godoc.org/github.com/eduncan911/podcast.
### Extensibility
In no way are you restricted in having full control over your feeds. You may
@@ -47,8 +44,15 @@ Podcasts: ht
* Initial release.
* Full documentation, full examples and complete code coverage.
+## Table of Contents
+
+* [Imported Packages](#pkg-imports)
+* [Index](#pkg-index)
+* [Examples](#pkg-examples)
+## Imported Packages
+- [github.com/pkg/errors](https://godoc.org/github.com/pkg/errors)
## Index
* [type Author](#Author)
@@ -59,16 +63,16 @@ Podcasts: ht
* [type IImage](#IImage)
* [type Image](#Image)
* [type Item](#Item)
- * [func (i *Item) AddEnclosure(url string, enclosureType EnclosureType, lengthInSeconds int64)](#Item.AddEnclosure)
+ * [func (i \*Item) AddEnclosure(url string, enclosureType EnclosureType, lengthInSeconds int64)](#Item.AddEnclosure)
* [type Podcast](#Podcast)
- * [func New(title, link, description string, pubDate, lastBuildDate *time.Time) Podcast](#New)
- * [func (p *Podcast) AddAuthor(name, email string)](#Podcast.AddAuthor)
- * [func (p *Podcast) AddCategory(category string, subCategories []string)](#Podcast.AddCategory)
- * [func (p *Podcast) AddImage(url string)](#Podcast.AddImage)
- * [func (p *Podcast) AddItem(i Item) (int, error)](#Podcast.AddItem)
- * [func (p *Podcast) Bytes() []byte](#Podcast.Bytes)
- * [func (p *Podcast) Encode(w io.Writer) error](#Podcast.Encode)
- * [func (p *Podcast) String() string](#Podcast.String)
+ * [func New(title, link, description string, pubDate, lastBuildDate \*time.Time) Podcast](#New)
+ * [func (p \*Podcast) AddAuthor(name, email string)](#Podcast.AddAuthor)
+ * [func (p \*Podcast) AddCategory(category string, subCategories []string)](#Podcast.AddCategory)
+ * [func (p \*Podcast) AddImage(url string)](#Podcast.AddImage)
+ * [func (p \*Podcast) AddItem(i Item) (int, error)](#Podcast.AddItem)
+ * [func (p \*Podcast) Bytes() []byte](#Podcast.Bytes)
+ * [func (p \*Podcast) Encode(w io.Writer) error](#Podcast.Encode)
+ * [func (p \*Podcast) String() string](#Podcast.String)
* [type TextInput](#TextInput)
#### Examples
@@ -82,14 +86,9 @@ Podcasts: ht
* [Package (IoWriter)](#example__ioWriter)
#### Package files
-[author.go](/src/github.com/eduncan911/podcast/author.go) [doc.go](/src/github.com/eduncan911/podcast/doc.go) [enclosure.go](/src/github.com/eduncan911/podcast/enclosure.go) [image.go](/src/github.com/eduncan911/podcast/image.go) [item.go](/src/github.com/eduncan911/podcast/item.go) [itunes.go](/src/github.com/eduncan911/podcast/itunes.go) [podcast.go](/src/github.com/eduncan911/podcast/podcast.go) [textinput.go](/src/github.com/eduncan911/podcast/textinput.go)
+[author.go](./author.go) [doc.go](./doc.go) [enclosure.go](./enclosure.go) [image.go](./image.go) [item.go](./item.go) [itunes.go](./itunes.go) [podcast.go](./podcast.go) [textinput.go](./textinput.go)
-
-
-
-
-
-## type [Author](/src/target/author.go?s=150:288#L1)
+## type [Author](./author.go#L8-L12)
``` go
type Author struct {
XMLName xml.Name `xml:"itunes:owner"`
@@ -101,16 +100,7 @@ Author represents a named author and email.
For iTunes compliance, both Name and Email are required.
-
-
-
-
-
-
-
-
-
-## type [Enclosure](/src/target/enclosure.go?s=814:1118#L36)
+## type [Enclosure](./enclosure.go#L46-L53)
``` go
type Enclosure struct {
XMLName xml.Name `xml:"enclosure"`
@@ -123,22 +113,12 @@ type Enclosure struct {
```
Enclosure represents a download enclosure.
-
-
-
-
-
-
-
-
-
-## type [EnclosureType](/src/target/enclosure.go?s=274:296#L11)
+## type [EnclosureType](./enclosure.go#L21)
``` go
type EnclosureType int
```
EnclosureType specifies the type of the enclosure.
-
``` go
const (
M4A EnclosureType = iota
@@ -152,25 +132,13 @@ const (
```
EnclosureType specifies the type of the enclosure.
-
-
-
-
-
-
-
-
-
-### func (EnclosureType) [String](/src/target/enclosure.go?s=371:410#L14)
+### func (EnclosureType) [String](./enclosure.go#L24)
``` go
func (et EnclosureType) String() string
```
String returns the MIME type encoding of the specified EnclosureType.
-
-
-
-## type [ICategory](/src/target/itunes.go?s=645:782#L12)
+## type [ICategory](./itunes.go#L22-L26)
``` go
type ICategory struct {
XMLName xml.Name `xml:"itunes:category"`
@@ -180,16 +148,7 @@ type ICategory struct {
```
ICategory is a 2-tier classification system for iTunes.
-
-
-
-
-
-
-
-
-
-## type [IImage](/src/target/itunes.go?s=487:584#L6)
+## type [IImage](./itunes.go#L16-L19)
``` go
type IImage struct {
XMLName xml.Name `xml:"itunes:image"`
@@ -205,16 +164,7 @@ extensions (.jpg, .png), and in the RGB colorspace. To optimize
images for mobile devices, Apple recommends compressing your
image files.
-
-
-
-
-
-
-
-
-
-## type [Image](/src/target/image.go?s=398:676#L3)
+## type [Image](./image.go#L13-L21)
``` go
type Image struct {
XMLName xml.Name `xml:"image"`
@@ -235,16 +185,7 @@ extensions (.jpg, .png), and in the RGB colorspace. To optimize
images for mobile devices, Apple recommends compressing your
image files.
-
-
-
-
-
-
-
-
-
-## type [Item](/src/target/item.go?s=606:1746#L15)
+## type [Item](./item.go#L25-L50)
``` go
type Item struct {
XMLName xml.Name `xml:"item"`
@@ -291,26 +232,14 @@ Recommendations:
- Always set an Enclosure.Length, to be nice to your downloaders.
- Use Enclosure.Type instead of setting TypeFormatted for valid extensions.
-
-
-
-
-
-
-
-
-
-### func (\*Item) [AddEnclosure](/src/target/item.go?s=1813:1906#L43)
+### func (\*Item) [AddEnclosure](./item.go#L53-L54)
``` go
func (i *Item) AddEnclosure(
url string, enclosureType EnclosureType, lengthInSeconds int64)
```
AddEnclosure adds the downloadable asset to the podcast Item.
-
-
-
-## type [Podcast](/src/target/podcast.go?s=176:1822#L9)
+## type [Podcast](./podcast.go#L19-L58)
``` go
type Podcast struct {
XMLName xml.Name `xml:"channel"`
@@ -354,13 +283,7 @@ type Podcast struct {
```
Podcast represents a podcast.
-
-
-
-
-
-
-### func [New](/src/target/podcast.go?s=1988:2073#L54)
+### func [New](./podcast.go#L64-L65)
``` go
func New(title, link, description string,
pubDate, lastBuildDate *time.Time) Podcast
@@ -370,20 +293,13 @@ New instantiates a Podcast with required parameters.
Nil-able fields are optional but recommended as they are formatted
to the expected proper formats.
-
-
-
-
-### func (\*Podcast) [AddAuthor](/src/target/podcast.go?s=2719:2766#L79)
+### func (\*Podcast) [AddAuthor](./podcast.go#L89)
``` go
func (p *Podcast) AddAuthor(name, email string)
```
AddAuthor adds the specified Author to the podcast.
-
-
-
-### func (\*Podcast) [AddCategory](/src/target/podcast.go?s=2998:3068#L90)
+### func (\*Podcast) [AddCategory](./podcast.go#L100)
``` go
func (p *Podcast) AddCategory(category string, subCategories []string)
```
@@ -391,10 +307,7 @@ AddCategory adds the categories to the Podcast in comma delimited format.
subCategories are optional.
-
-
-
-### func (\*Podcast) [AddImage](/src/target/podcast.go?s=3845:3883#L118)
+### func (\*Podcast) [AddImage](./podcast.go#L128)
``` go
func (p *Podcast) AddImage(url string)
```
@@ -407,10 +320,7 @@ extensions (.jpg, .png), and in the RGB colorspace. To optimize
images for mobile devices, Apple recommends compressing your
image files.
-
-
-
-### func (\*Podcast) [AddItem](/src/target/podcast.go?s=5354:5400#L166)
+### func (\*Podcast) [AddItem](./podcast.go#L176)
``` go
func (p *Podcast) AddItem(i Item) (int, error)
```
@@ -452,45 +362,31 @@ Recommendations:
* Always set an Enclosure.Length, to be nice to your downloaders.
* Follow Apple's best practices to enrich your podcasts:
-
https://help.apple.com/itc/podcasts_connect/#/itc2b3780e76
* For specifications of itunes tags, see:
-
https://help.apple.com/itc/podcasts_connect/#/itcb54353390
-
-
-
-### func (\*Podcast) [Bytes](/src/target/podcast.go?s=7223:7255#L234)
+### func (\*Podcast) [Bytes](./podcast.go#L244)
``` go
func (p *Podcast) Bytes() []byte
```
Bytes returns an encoded []byte slice.
-
-
-
-### func (\*Podcast) [Encode](/src/target/podcast.go?s=7365:7408#L239)
+### func (\*Podcast) [Encode](./podcast.go#L249)
``` go
func (p *Podcast) Encode(w io.Writer) error
```
Encode writes the bytes to the io.Writer stream in RSS 2.0 specification.
-
-
-
-### func (\*Podcast) [String](/src/target/podcast.go?s=7677:7710#L250)
+### func (\*Podcast) [String](./podcast.go#L260)
``` go
func (p *Podcast) String() string
```
String encodes the Podcast state to a string.
-
-
-
-## type [TextInput](/src/target/textinput.go?s=77:290#L1)
+## type [TextInput](./textinput.go#L6-L12)
``` go
type TextInput struct {
XMLName xml.Name `xml:"textInput"`
@@ -502,18 +398,5 @@ type TextInput struct {
```
TextInput represents text inputs.
-
-
-
-
-
-
-
-
-
-
-
-
-
- - -
-Generated by [godoc2md](http://godoc.org/github.com/davecheney/godoc2md)
+Generated by [godoc2ghmd](https://github.com/eduncan911/godoc2ghmd)
\ No newline at end of file
diff --git a/doc.go b/doc.go
index 539a0c5..eedf08b 100644
--- a/doc.go
+++ b/doc.go
@@ -1,21 +1,25 @@
-// Package podcast is an iTunes and RSS 2.0 podcast generator for GoLang that
-// enforces strict compliance by using its simple interface.
+// Package podcast generates a fully compliant iTunes and RSS 2.0 podcast feed
+// for GoLang using a simple API.
//
// Full documentation with detailed examples located at https://godoc.org/github.com/eduncan911/podcast
//
// Usage
//
+// To use, `go get` and `import` the package like your typical GoLang library.
+//
// $ go get -u github.com/eduncan911/podcast
//
+// import "github.com/eduncan911/podcast"
+//
// The API exposes a number of method receivers on structs that implements the
// logic required to comply with the specifications and ensure a compliant feed.
// A number of overrides occur to help with iTunes visibility of your episodes.
//
-// Notably, the [Podcast.AddItem(i Item)](#Podcast.AddItem) function performs most of the
-// heavy lifting by taking the [Item](#Item) input and performing validation, overrides
-// and duplicate setters through the feed.
+// Notably, the [Podcast.AddItem(i Item)](#Podcast.AddItem) function performs most
+// of the heavy lifting by taking the [Item](#Item) input and performing
+// validation, overrides and duplicate setters through the feed.
//
-// See the detailed Examples in the GoDocs for complete usage.
+// See the detailed Examples of the API at https://godoc.org/github.com/eduncan911/podcast.
//
// Extensibility
//