Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Tool usage page: fix time range claims and add utility

Aperta Adatta ai principianti
  • Qualcosa non va?
#1,185 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Ambito
documentation

Direzione di ricerca

Modifica docs/connector-gateway/tool-usage.mdx, iniziando dalle righe indicate e dalla struttura attuale della pagina. Aggiorna la formulazione dell’intervallo di tempo e della UI, spiega a quali domande degli amministratori aiuta a rispondere la pagina, aggiungi i link specificati ai dettagli sull’utilizzo e sposta la risoluzione dei problemi in una sezione dedicata. Includi il prerequisito per il metering una volta che #1179 lo avrà confermato; il lavoro sarà completato quando le raccomandazioni saranno riportate correttamente nella pagina.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

bug documentation needs-triage

Part of #1175. Page: docs/connector-gateway/tool-usage.mdx

Problems

  1. The time range claim is misleading (lines 12-13). The page implies the time range controls everything on the screen. The options are Last 24h, Last 7d, and Last 30d, with 24h the default. They drive the tiles and the tables, but the Tool calls trend chart always shows Last 3 months, whatever range is selected.
  2. The page doesn't help the reader answer anything. It lists what's on screen, but not what an admin can learn from it, such as which connectors are unused, where adoption is growing, or which tools are called most. It doesn't mention drill-down either. Connector names in the tables aren't links, and per-user detail is only on each connector's Activity tab.
  3. Troubleshooting is mixed into the body (lines 20-22), and it leaves out the most likely cause of an empty screen: the metering prerequisite tracked in #1179.
  4. Minor:
    • The console title is Tool Usage (title case). Match it when bolding the UI label.
    • Line 15 says "integrations". Use "connectors".

Recommendations

  • List the time range options and the default, and state that the chart's window is fixed at 3 months
  • Document the tiles (Tool calls, Active connectors, Top connector) and the table columns (By connector: Connector, Calls, Share; By tool: Tool, Connector, Calls, Share)
  • Frame the page around two or three admin questions it answers
  • Link to the connector Activity tab for per-user and per-call detail
  • Mention that users see their own usage on the Usage tab in the User experience
  • Move lines 20-22 into a Troubleshooting section, and add the metering prerequisite once #1179 confirms it
Lingua principale
TypeScript
Stelle
4
Fork
3
Merge medio
22h
PR unite (30g)
37

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di stacklok/docs-website

Tutte le issue di stacklok/docs-website

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.