Move commentary for client methods to the actual interface.

client.go

@@ -16,16 +16,38 @@ Provides a high-level client to talk to the API that football-data.org offers.
 To create an instance please use NewClient(h).
 */
 type Client interface {
+	// Fixture prepares a request to fetch the fixtures of a soccer season.
 	Fixture(id uint64) FixtureRequest
+
+	// Fixtures prepares a request to fetch the fixtures of a soccer season.
 	Fixtures() FixturesRequest
-	SoccerSeason(id uint64) SoccerSeasonRequest
+
+	// FixturesOfSoccerSeason prepares a request to fetch the fixtures of a soccer season.
 	FixturesOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonFixturesRequest
-	LeagueTableOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonLeagueTableRequest
-	TeamsOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonTeamsRequest
-	SoccerSeasons() SoccerSeasonsRequest
-	Team(id uint64) TeamRequest
+
+	// FixturesOfTeam prepares a request to fetch the fixtures of a soccer season.
 	FixturesOfTeam(id uint64) TeamFixturesRequest
 
+	// LeagueTableOfSoccerSeason prepares a new request to fetch the league table of a given soccer season.
+	LeagueTableOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonLeagueTableRequest
+
+	// PlayersOfTeam prepares a request to fetch a team's players.
+	PlayersOfTeam(id uint64) TeamPlayersRequest
+
+	// SoccerSeason prepares a request to fetch the complete list of soccer seasons.
+	SoccerSeason(id uint64) SoccerSeasonRequest
+
+	// SoccerSeasons prepares a request to fetch the complete list of soccer seasons.
+	SoccerSeasons() SoccerSeasonsRequest
+
+	// Team prepares a request to fetch a team's information.
+	Team(id uint64) TeamRequest
+
+	// TeamsOfSoccerSeason prepares a new request to fetch the league table of a given soccer season.
+	TeamsOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonTeamsRequest
+
+	// SetToken sets the authentication token.
+	// Calling this method is *optional*.
 	SetToken(authToken string)
 }
 
@@ -48,8 +70,6 @@ func NewClient(h *http.Client) Client {
 	return &client{httpClient: h}
 }
 
-// SetToken sets the authentication token.
-// Calling this method is *optional*.
 func (c *client) SetToken(authToken string) {
 	c.AuthToken = authToken
 }

req_fixture.go

@@ -21,7 +21,6 @@ func (r FixtureRequest) Do() (s Fixture, err error) {
 	return
 }
 
-// Fixture prepares a request to fetch the fixtures of a soccer season.
 func (c *client) Fixture(id uint64) FixtureRequest {
 	return FixtureRequest{c.req("fixture/%d", id)}
 }

req_fixtures.go

@@ -30,7 +30,6 @@ func (r FixturesRequest) Do() (s FixturesResponse, err error) {
 	return
 }
 
-// Fixtures prepares a request to fetch the fixtures of a soccer season.
 func (c *client) Fixtures() FixturesRequest {
 	return FixturesRequest{c.req("fixtures")}
 }

req_soccerseason.go

@@ -13,7 +13,6 @@ func (r SoccerSeasonRequest) Do() (s SoccerSeason, err error) {
 	return
 }
 
-// SoccerSeason prepares a request to fetch the complete list of soccer seasons.
 func (c *client) SoccerSeason(id uint64) SoccerSeasonRequest {
 	return SoccerSeasonRequest{c.req("soccerseasons/%d", id)}
 }

req_soccerseason_fixtures.go

@@ -30,7 +30,6 @@ func (r SoccerSeasonFixturesRequest) Do() (s FixtureList, err error) {
 	return
 }
 
-// FixturesOfSoccerSeason prepares a request to fetch the fixtures of a soccer season.
 func (c *client) FixturesOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonFixturesRequest {
 	return SoccerSeasonFixturesRequest{c.req("soccerseasons/%d/fixtures", soccerSeasonId)}
 }

req_soccerseason_leaguetable.go

@@ -21,7 +21,6 @@ func (r SoccerSeasonLeagueTableRequest) Do() (s SoccerSeason, err error) {
 	return
 }
 
-// LeagueTableOfSoccerSeason prepares a new request to fetch the league table of a given soccer season.
 func (c *client) LeagueTableOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonLeagueTableRequest {
 	return SoccerSeasonLeagueTableRequest{c.req("soccerseasons/%d/leagueTable", soccerSeasonId)}
 }

req_soccerseason_teams.go

@@ -13,7 +13,6 @@ func (r SoccerSeasonTeamsRequest) Do() (s TeamList, err error) {
 	return
 }
 
-// TeamsOfSoccerSeason prepares a new request to fetch the league table of a given soccer season.
 func (c *client) TeamsOfSoccerSeason(soccerSeasonId uint64) SoccerSeasonTeamsRequest {
 	return SoccerSeasonTeamsRequest{c.req("soccerseasons/%d/leagueTable", soccerSeasonId)}
 }

req_soccerseasons.go

@@ -21,7 +21,6 @@ func (r SoccerSeasonsRequest) Do() (s SoccerSeasonList, err error) {
 	return
 }
 
-// SoccerSeasons prepares a request to fetch the complete list of soccer seasons.
 func (c *client) SoccerSeasons() SoccerSeasonsRequest {
 	return SoccerSeasonsRequest{c.req("soccerseasons")}
 }

req_team.go

@@ -20,7 +20,6 @@ func (r TeamRequest) Do() (s Team, err error) {
 	return
 }
 
-// Team prepares a request to fetch a team's information.
 func (c *client) Team(id uint64) TeamRequest {
 	return TeamRequest{c.req("teams/%d", id), id}
 }

req_team_fixtures.go

@@ -36,7 +36,6 @@ func (r TeamFixturesRequest) Do() (s FixturesResponse, err error) {
 	return
 }
 
-// FixturesOfTeam prepares a request to fetch the fixtures of a soccer season.
 func (c *client) FixturesOfTeam(id uint64) TeamFixturesRequest {
 	return TeamFixturesRequest{c.req("teams/%d/fixtures", id)}
 }

req_team_players.go

@@ -13,7 +13,6 @@ func (r TeamPlayersRequest) Do() (s PlayerList, err error) {
 	return
 }
 
-// PlayersOfTeam prepares a request to fetch a team's players.
 func (c *client) PlayersOfTeam(id uint64) TeamPlayersRequest {
 	return TeamPlayersRequest{c.req("teams/%d/players", id)}
 }