add comments about the new alternatives

static/app/utils/useTeams.tsx

@@ -93,6 +93,7 @@ type FetchTeamOptions = {
 
 /**
  * Helper function to actually load teams
+ *
  */
 async function fetchTeams(
   api: Client,
@@ -158,6 +159,13 @@ async function fetchTeams(
  * loaded, so you should use this hook with the intention of providing specific
  * slugs, or loading more through search.
  *
+ * @deprecated use the alternatives to this hook (except for search and pagination)
+ * new alternatives:
+ * - useTeamsById({ids: []}) - get teams by id
+ * - useTeamsById({slugs: []}) - get teams by slug
+ * - useTeamsById() - just reading from the teams store
+ * - useUserTeams() - same as `provideUserTeams: true`
+ *
  */
 export function useTeams({limit, slugs, provideUserTeams}: Options = {}) {
   const api = useApi();