diff --git a/bot.go b/bot.go
index bf71a06..2213179 100644
--- a/bot.go
+++ b/bot.go
@@ -1,3 +1,4 @@
+// Methods for interacting with the Telegram Bot API.
 package tgbotapi
 
 type BotApi struct {
@@ -7,6 +8,8 @@ type BotApi struct {
 	Updates chan Update `json:"-"`
 }
 
+// Creates a new BotApi instance.
+// Requires a token, provided by @BotFather on Telegram
 func NewBotApi(token string) (*BotApi, error) {
 	bot := &BotApi{
 		Token: token,
diff --git a/updates.go b/updates.go
index 0d0847a..6372409 100644
--- a/updates.go
+++ b/updates.go
@@ -1,5 +1,6 @@
 package tgbotapi
 
+// Returns a chan that is called whenever a new message is gotten.
 func (bot *BotApi) UpdatesChan(config UpdateConfig) (chan Update, error) {
 	bot.Updates = make(chan Update, 100)