Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Tool usage page: fix time range claims and add utility

Abierto Apto para principiantes
  • ¿Algo no está bien?
#1,185 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Área
documentation

Línea de trabajo

Edita docs/connector-gateway/tool-usage.mdx, comenzando por las líneas indicadas y la estructura actual de la página. Actualiza la redacción sobre el intervalo de tiempo y la UI, explica qué preguntas de los administradores ayuda a responder la página, añade los enlaces especificados a los detalles de uso y mueve la solución de problemas a su propia sección. Incluye el requisito previo de metering una vez que #1179 lo confirme; estará terminado cuando las recomendaciones se reflejen correctamente en la página.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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
Lenguaje dominante
TypeScript
Estrellas
4
Forks
3
Merge medio
22 h
PR fusionados (30 d)
37

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de stacklok/docs-website

Todos los issues de stacklok/docs-website

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.