ImranR98/apps.obtainium.imranr.dev

Proposal: Add a POLICY document for file structure and version conventions

Aberta

#1.568 aberto em 30 de jul. de 2026

Ver no GitHubGuia do colaborador
 (4 comentários) (0 reação) (0 responsável)Astro (160 forks)github user discovery
enhancementhelp wanted

Métricas do repositório

Stars
 (553 estrelas)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

Description

I propose that we add a POLICY document to structure how files should look and standardize conventions for version numbers.

Example Proposal: Standardize Unofficial Version Numbers

Some apps use unofficial version numbers when stable release formats cannot be applied. For example, the Nightly releases of RetroArch currently use a plain date format (YYYY-MM-DD) because the official version number cannot be added to them (e.g, 1.22.2):

The versionExtractionRegEx\":\"\\\\d{4}-\\\\d{2}-\\\\d{2}\" in these configuration files handles this format:

Proposed Rule

Unofficial version numbers should be enclosed in square brackets. Under this policy, plain dates like YYYY-MM-DD would be formatted as [YYYY-MM-DD] (e.g., for RetroArch Nightly builds).

Guia do colaborador

Direção de pesquisa
Inspecione a estrutura do repositório e os arquivos de configuração JSON, especialmente os exemplos do RetroArch. Entenda a regex atual de extração de versão e como os números de versão não oficiais são tratados. Planeje um documento POLICY que defina a nova convenção entre colchetes e identifique todos os arquivos que precisariam ser atualizados.
Pilha de tecnologia
astro
Domain
datadocumentation
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
GitJSON
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
80