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

Docs MCP URL normalization retains query strings and fragments

Abierto Apto para principiantes
#1,618 1 comentario 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
73/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
typescript
Área
tooling

Línea de trabajo

Lee normalizeDocPath y fetchDocPage en el fetcher de docs MCP y sigue después la configuración existente de pruebas de fetch y caché con mocks. Cubre las URL completas de docs y las rutas relativas con consultas o fragmentos, comprobando la ruta de salida y la URL canónica de cita, y conservando las rutas admitidas y el límite exacto del origen. El trabajo estará terminado cuando esos casos pasen y las respuestas HTML ya no se almacenen en caché como Markdown debido a una solicitud .md mal formada.

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

Descripción

bug MCP

Full docs URLs containing a query string or fragment can bypass the Markdown export. normalizeDocPath preserves ? and #, then fetchDocPage appends .md to the whole string.

For example, https://docs.sentry.io/platforms/javascript/#tracing produces a request with pathname /platforms/javascript/ and fragment #tracing.md. A query string similarly receives the suffix instead of the pathname. The fetcher accepts a successful HTML response and can cache it as Markdown for one hour.

Verified against the actual fetcher with mocked fetch/cache and no network calls. This is inherited from the original Worker, rather than introduced by the URL prefix-boundary correction in the port PR #1597.

Follow-up scope:

  • Strip query strings and fragments before suffix/trailing-slash normalization and use the resulting pathname for the .md request.
  • Cover full docs URLs and relative paths with query strings/fragments, including the outbound pathname and canonical citation URL.
  • Preserve the exact-origin boundary and existing supported path forms.

Keep this behavior change outside the migration PR.

Lenguaje dominante
TypeScript
Estrellas
938
Forks
166
Merge medio
1 d 4 h
PR fusionados (30 d)
175

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

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 getsentry/toolkit

Todos los issues de getsentry/toolkit

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.