From 2497684181e131be5616e36bf9cdc6d3da7db290 Mon Sep 17 00:00:00 2001
From: Ilya Kaznacheev <ilya@kaznacheev.me>
Date: Sat, 24 Oct 2020 16:30:45 +0300
Subject: [PATCH] Add location, venue and user profile photos type
 documentation

---
 types.go | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/types.go b/types.go
index 50c1425..0698d40 100644
--- a/types.go
+++ b/types.go
@@ -613,22 +613,31 @@ type Contact struct {
 
 // Location contains information about a place.
 type Location struct {
+	// Longitude as defined by sender
 	Longitude float64 `json:"longitude"`
-	Latitude  float64 `json:"latitude"`
+	// Latitude as defined by sender
+	Latitude float64 `json:"latitude"`
 }
 
 // Venue contains information about a venue, including its Location.
 type Venue struct {
-	Location     Location `json:"location"`
-	Title        string   `json:"title"`
-	Address      string   `json:"address"`
-	FoursquareID string   `json:"foursquare_id"` // optional
+	// Location venue location
+	Location Location `json:"location"`
+	// Title name of the venue
+	Title string `json:"title"`
+	// Address of the venue
+	Address string `json:"address"`
+	// FoursquareID foursquare identifier of the venue
+	// optional
+	FoursquareID string `json:"foursquare_id"`
 }
 
 // UserProfilePhotos contains a set of user profile photos.
 type UserProfilePhotos struct {
-	TotalCount int           `json:"total_count"`
-	Photos     [][]PhotoSize `json:"photos"`
+	// TotalCount total number of profile pictures the target user has
+	TotalCount int `json:"total_count"`
+	// Photos requested profile pictures (in up to 4 sizes each)
+	Photos [][]PhotoSize `json:"photos"`
 }
 
 // File contains information about a file to download from Telegram.