Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Define a documented convention for pairing short and long option names in specs

Aperta
#374 6 commenti 0 reazioni 0 assegnatari Vedi su GitHub

@warp-factories ci sta già lavorando.

Dal 28/8/2026.

  • #376 di @warp-factories — aperta

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
62/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
rust
Ambito
cli, documentation

Direzione di ricerca

Start by locating the existing option specs and contributor documentation in the repository, then read how short and long names and exclusiveOn lists are currently represented. Document when equivalent names should be paired or separate, how paired options are referenced, and the contributor-facing location; done means the convention is written clearly where contributors will find it.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

documentation ready-to-implement repro:high triaged

Specs are inconsistent about whether equivalent short/long options are modeled as separate entries or as a paired name array (e.g. ["-d", "--max-depth"]). Contributors adding long forms don't have a documented convention to follow, which shows up in review churn. Requesting a written spec that defines the pairing convention (when to pair vs separate entries, how exclusiveOn lists should reference paired options) and where it should be documented for contributors.

Lingua principale
Rust
Stelle
6
Fork
11
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di warpdotdev/command-signatures

Tutte le issue di warpdotdev/command-signatures

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.