Mention of ‘timestamp’ in documentation for ‘cache’ parameter of ‘ajax’ is misleading
Evaluación
- Dificultad
- 1/5
- Tiempo estimado
- Menos de una hora
- Aptitud para principiantes
- 62/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Estancado
- Stack tecnológico
- jquery
- Área
- documentation
Línea de trabajo
Comienza con la entrada de documentación del parámetro cache de ajax y compara su redacción con las líneas 9435 y 8501 referenciadas de dist/jquery.js. Actualiza la descripción para que se refiera al valor añadido como uid en lugar de como una marca de tiempo; la redacción engañosa ya no debería aparecer.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
The documentation for the ‘cache’ parameter of ‘ajax’ says:
It works by appending "_={timestamp}" to the GET parameters.
This seems a bit misleading. I interpreted it as a timestamp of when the request is sent. But the value after _= is actually taken from a counter:
https://github.com/jquery/jquery/blob/f79d5f1a337528940ab7029d4f8bbba72326f269/dist/jquery.js#L9435
The counter is only initialized using Date.now():
https://github.com/jquery/jquery/blob/f79d5f1a337528940ab7029d4f8bbba72326f269/dist/jquery.js#L8501
I got confused by that when analyzing nginx access logs and wondering why the ‘timestamps’ didn’t match up.
The documentation should probably just say that it works by appending "_={uid}".
- Lenguaje dominante
- HTML
- Estrellas
- 324
- Forks
- 259
- Merge medio
- 1 d 30 min
- PR fusionados (30 d)
- 1
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de jquery/api.jquery.com
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
jquery/api.jquery.com#1176 ·
-
The documentation of CSS methods should be further classifiedQuizá libre de nuevo Un pull request para esta issue se cerró sin fusionarse. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 35/100
jquery/api.jquery.com#1281 · 2 comentarios ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 35/100
jquery/api.jquery.com#1271 · 2 comentarios ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 45/100
jquery/api.jquery.com#1259 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 45/100
jquery/api.jquery.com#1258 ·
Todos los issues de jquery/api.jquery.com
Issues similares
-
5-minutes algorithm all-levels any-language beginner-friendly community documentation easy first-timers-only good first issue hacktoberfest help wanted learning no-code-needed open-source python students
Dificultad 2/5 Menos de una hora Aptitud para principiantes 88/100
Huerte/algo-solutions-python#253 ·
Los mantenedores suelen responder en 1 día
-
size/s
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
sipyourdrink-ltd/bernstein#7179 ·
Los mantenedores suelen responder en 1 día
-
area/docs
Dificultad 1/5 Menos de una hora Aptitud para principiantes 86/100
meshery/meshery#23375 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Synthetic
Dificultad 1/5 Menos de una hora Aptitud para principiantes 66/100
samtoth/agda-synthetic-categories#373 ·
Los mantenedores suelen responder en 1 día
-
agent-system-test-1319336938-43312257375-1- Agent System assignment-policy flow 43312257375-1Abierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 62/100
tanaabased/big-test-bucket#19952 ·
Los mantenedores suelen responder en 1 día