ImranR98/apps.obtainium.imranr.dev

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

Aperta

#1568 aperta il 30 lug 2026

Vedi su GitHubGuida contributor
 (4 commenti) (0 reazioni) (0 assegnatari)Astro (156 fork)github user discovery
enhancementhelp wanted

Metriche repository

Star
 (551 stelle)
Metriche merge PR
 (Nessuna PR mergiata in 30 g)

Descrizione

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).

Guida contributor

Direzione di ricerca
Esamina la struttura del repository e i file di configurazione JSON, in particolare gli esempi di RetroArch. Comprendi l'attuale regex di estrazione della versione e come vengono gestiti i numeri di versione non ufficiali. Pianifica un documento POLICY che definisca la nuova convenzione tra parentesi e identifica tutti i file che dovrebbero essere aggiornati.
Tech stack
astro
Dominio
datadocumentation
Tipo issue
Documentazione
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
GitJSON
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
80