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

community: publish a "For publishers" page (what is recorded about you, how to correct it, preview opt-out, how to link back)

Fechada Para iniciantes
  • Algo errado?
#150 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
78/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
javascript
Domínio
documentation

Direção de pesquisa

Leia as regras voltadas a quem publica em CONTRIBUTING.md:84-92, o formulário Correction em correction.yml:21-26, a linha de crédito da entrada em entry-page.mjs:106 e a seção Contributing do README. Adicione docs/for-publishers.md, os links solicitados e a opção do formulário. O trabalho estará concluído quando quem publica puder ler a política, corrigir um fato e optar por não receber uma prévia sem ler CONTRIBUTING.

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

Descrição

community marketing priority: medium

Why it matters

Roughly 170 entries carry a publisher (Kenney, Quaternius, KayKit, Epic, Blender Studio, NASA and others). Publishers are the catalog's most credible amplifiers and the people most likely to notice an error, yet the rules that concern them are scattered across contributor sub-sections. Distinct from #117 (badge assets) and #112 (credit lines): this is the page those would link to.

Evidence (at 69387df)

  • Publisher-facing rules live only inside contributor docs: self-listing policy CONTRIBUTING.md:84-86; preview opt-out and pinning CONTRIBUTING.md:92. Removing a thumbnail is "open an issue" with no template option (the Correction dropdown at correction.yml:21-26 has no "I am the publisher / remove my preview" choice).
  • No page tells a publisher how the catalog describes their licence, that the quote is theirs and dated, how they would be told of a change, or that entries never rehost (README.md:22-24 is phrased for consumers).
  • The entry-page caption "Preview image from Kenney, shown under CC0" (entry-page.mjs:106) is already a visible publisher touchpoint with no destination to read more.

Suggested approach

docs/for-publishers.md (one screen): what an entry records, how to correct it (link the Correction form), how to be told about a re-read (subscribe to reverified.xml), preview policy and opt-out, self-listing rules, and "link to your entry" with the canonical URL pattern. Add "I am the publisher of this source" to the Correction form's dropdown. Link the page from the entry-page credit line and from the README Contributing section.

Done when

A publisher who finds their entry can read the policy, fix a fact and opt out of a preview without reading CONTRIBUTING.

Linguagem predominante
JavaScript
Estrelas
58
Forks
15
Merge médio
16h 53min
PRs com merge (30d)
14

Preparar o ambiente

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 TMHSDigital/Free-Game-Dev-Assets

Todas as issues de TMHSDigital/Free-Game-Dev-Assets

Issues semelhantes

Mais issues de JavaScript

Receba novas issues na sua caixa de entrada

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