Generate hash for index.json requests (FSharp.Formatting issue)
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Accessibilité débutants
- 35/100
- Type d'issue
- Fonctionnalité
- Clarté
- Plutôt claire
- Activité
- À l'abandon
- Stack technique
- fsharp, javascript
- Domaine
- documentation
Piste de recherche
Commencez par docs/content/fsdocs-search.js à la ligne 14 et suivez le chemin de templating qui génère index.json et les URL d’assets générées. Déterminez comment les liens générés et les références CSS ou script sont produits ; le travail est terminé lorsque le contenu actualisé reçoit une valeur de requête de hash afin que les navigateurs ne réutilisent pas les réponses obsolètes de index.json.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
The index.json search index cached by browsers may become out of date as the site gets refreshed
This is an FSharp.Formatting issue (specifically in fsdocs-search.js) noted by @baronfel in https://github.com/fsharp/fsharp-core-docs/pull/27#issuecomment-667561113
Cool. How do we check that? Here's the request: fsprojects/FSharp.Formatting@master/docs/content/fsdocs-search.js#L14
Regarding this point, I'd suggest that that content rendered by the templating engine render the content, and provide a hashed value for this specific content
Then, when rendering links/src elements to generated content files, append the hash to the query string. This would mean that urls like the one in the search JS you linked would need to be templated as well. Same for css links in the html head elements, etc.
- Langage dominant
- Aucune donnée de langage
- Étoiles
- 37
- Forks
- 20
- Merge moyen
- 5 min
- PR mergées (30 j)
- 2
Guide de contribution
Aucun guide de contribution indexé pour ce dépôt
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de fsharp/fsharp-core-docs
-
Missing namespaces? Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 45/100
fsharp/fsharp-core-docs#104 · 6 commentaires ·
-
Build doesn't work on Linux? Ouverte
Difficulté 4/5 3-5 jours Accessibilité débutants 25/100
fsharp/fsharp-core-docs#103 · 4 commentaires ·
-
Difficulté 3/5 1-2 jours Accessibilité débutants 38/100
fsharp/fsharp-core-docs#82 ·
-
Move to docs.fsharp.org? Ouverte
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100
fsharp/fsharp-core-docs#76 · 4 commentaires · 9 réactions ·
-
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100
fsharp/fsharp-core-docs#75 · 3 commentaires · 1 réaction ·
Toutes les issues de fsharp/fsharp-core-docs
Issues similaires
-
agent-ready documentation needs-triage
Difficulté 1/5 1-3 heures Accessibilité débutants 88/100
-
untriaged
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
dotnet/dotnet-api-docs#13095 ·
-
documentation
Difficulté 1/5 Moins d'une heure Accessibilité débutants 91/100
-
workflow-status page template still says reusable workflows are "triggered only by workflow_call:" Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 92/100
-
refactor
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100