See #367 for discussion.

Change-Id: I10e26bddebeea2a1485fc4389caab1ff12421382

It's not obvious from reading the GitHub API docs or the go-github docs
that RepositoryContent.Content may be base64 encoded.  This adds
clarifying docs for that as well as the String method.

Also add an example of using the GetReadme method.

Fixes #322
Fixes #323

Decode only works if r.Content is actually encoded, which I'm not sure
that it always will be.  GetContent will return the content, decoding it
only if necessary.  Deprecate the old Decode method.

Also expand and cleanup the tests for both of these methods.

Related to #323

Fixes #308.
Fixes #309.

Change-Id: I71d1422c90f32cc6e6834ed428a311a2b2b88778

With this code it should be possible to tick the ‘Content’ box in issue
#37. The code is written after reviewing PR #64 and so is (very)
loosely based on that PR. So big thanks for the work already done by
@octavore! I did however had some different insights about a few fixes
and as the PR hasn’t moved for the last 5 months, I thought to just
rewrite and PR and I send in a new PR hoping to come to a merge…