Add template function overview to README

README.md

@@ -22,11 +22,54 @@ Render to a file:
 ## Templates
 
 You can find an example template to generate a GitHub profile README under
-`templates/github-profile.tpl`. Make sure to fill in the placeholders, like
-the RSS-feed or social media URLs.
+`templates/github-profile.tpl`. Make sure to fill in (or remove) placeholders,
+like the RSS-feed or social media URLs.
 
 Rendered it looks a little like my own profile page: https://github.com/muesli
 
+## Functions
+
+### Fetch repositories you recently created
+
+```
+{{range recentRepos 10}}
+Name: {{.Name}}
+Description: {{.Description}}
+URL: {{.URL}})
+Stars: {{.Stargazers}}
+{{end}}
+```
+
+### Fetch recent releases you contributed to
+
+```
+{{range recentReleases 10}}
+Name: {{.Name}}
+Git Tag: {{.LastRelease.TagName}}
+URL: {{.LastRelease.URL}}
+Published: {{humanize .LastRelease.PublishedAt}}
+{{end}}
+```
+
+### Fetch your latest followers
+
+```
+{{range followers 5}}
+Username: {{.Login}}
+URL: {{.URL}}
+{{end}}
+```
+
+### Retrieve RSS feed
+
+```
+{{range rss "https://.../feed.xml" 5}}
+Title: {{.Title}}
+URL: {{.URL}}
+Published: {{humanize .PublishedAt}}
+{{end}}
+```
+
 ## Template Engine
 
 markscribe uses Go's powerful template engine. You can find its documentation