Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Generate hash for index.json requests (FSharp.Formatting issue)

Aberta
#33 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Estagnada
Stack de tecnologia
fsharp, javascript
Domínio
documentation

Direção de pesquisa

Comece por docs/content/fsdocs-search.js na linha 14 e rastreie o caminho de templating que emite index.json e URLs de assets geradas. Determine como os links gerados e as referências a CSS ou scripts são produzidos; considera-se concluído quando o conteúdo atualizado recebe um valor de consulta hash para que os navegadores não reutilizem respostas obsoletas de index.json.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

fsdocs

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.

Linguagem predominante
Sem dados de linguagem
Estrelas
37
Forks
20
Merge médio
5min
PRs com merge (30d)
2

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de fsharp/fsharp-core-docs

Todas as issues de fsharp/fsharp-core-docs

Issues semelhantes

Mais issues de Documentation

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.