adding comment header and links to relevant docs in example files

examples/add_a_saved_album.py

@@ -1,3 +1,6 @@
+# code example that demonstrates current_user_saved_albums_add(albums=[]) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.current_user_saved_albums_add
+
 import argparse
 import logging
 
@@ -16,11 +19,11 @@ def get_args():
                         required=True, help='Album ids')
     return parser.parse_args()
 
-# TODO
+
 def main():
     args = get_args()
     sp = spotipy.Spotify(auth_manager=SpotifyOAuth(scope=scope))
-    sp.current_user_saved_albums_add(albums=args.aids)
+    sp.current_user_saved_albums_add(albums=args.aids) 
 
 
 if __name__ == '__main__':

examples/add_a_saved_track.py

@@ -1,3 +1,6 @@
+# code example that demonstrates current_user_saved_tracks_add(tracks=None) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.current_user_saved_tracks_add
+
 import argparse
 import logging
 

examples/add_tracks_to_playlist.py

@@ -1,3 +1,6 @@
+# code example that demonstrates playlist_add_items(playlist_id, items, position=None) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.playlist_add_items
+
 import argparse
 import logging
 

examples/audio_features_for_track.py

@@ -1,5 +1,5 @@
-
-
+# code example that demonstrates audio_features(tracks=[]) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.audio_features
 # shows acoustic features for tracks for the given artist
 
 from __future__ import print_function    # (at top of module)

examples/contains_a_saved_track.py

@@ -1,3 +1,5 @@
+# code example that demonstrates current_user_saved_tracks_contains(tracks=None) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.current_user_saved_tracks_contains
 # Prints whether a track exists in your collection of saved tracks
 
 import pprint

examples/create_playlist.py

@@ -1,3 +1,5 @@
+# code example that demonstrates user_playlist_create(user, name, public=True, collaborative=False, description='') functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.user_playlist_create
 # Creates a playlist for a user
 
 import argparse

examples/delete_a_saved_track.py

@@ -1,3 +1,5 @@
+# code example that demonstrates current_user_saved_tracks_delete(tracks=None) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.current_user_saved_tracks_delete
 # Delete a track from 'Your Collection' of saved tracks
 
 import pprint

examples/follow_playlist.py

@@ -1,3 +1,6 @@
+# code example that demonstrates current_user_follow_playlist(playlist_id) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.current_user_follow_playlist
+
 import argparse
 
 import spotipy

examples/my_playlists.py

@@ -1,3 +1,5 @@
+# code example that demonstrates current_user_playlists(limit=50, offset=0) functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.current_user_playlists
 # Shows a user's playlists
 
 import spotipy

examples/my_top_artists.py

@@ -1,3 +1,5 @@
+# code example that demonstrates current_user_top_artists(limit=20, offset=0, time_range='medium_term') functionality
+# Link to documentation -> https://spotipy.readthedocs.io/en/2.22.1/#spotipy.client.Spotify.current_user_top_artists
 # Shows the top artists for a user
 import spotipy
 from spotipy.oauth2 import SpotifyOAuth