Add negative refspec examples to 10.5 Git Internals - The Refspec

Aperta Adatta ai principianti
#1,816 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
72/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
git
Ambito
documentation

Direzione di ricerca

Inizia dalla sezione “10.5 Git Internals - The Refspec” del Git Book collegata nell'issue, quindi confronta la documentazione pull-fetch collegata e l'esempio di Stack Overflow. Aggiungi un sottotitolo e/o esempi di refspec negative che spieghino la funzionalità in quella sezione. Il lavoro è completato quando il capitolo descrive chiaramente i marker delle refspec negative e la documentazione viene compilata correttamente.

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

Descrizione

enhancement
General overview of your idea.

Since Git v2.29.0, it has been possible to add negative refspec markers to the fetch config. These are modestly popular, but the documentation is buried in a multi-paragraph explanation on a fairly obscure doc page. Please consider adding a subheading and/or some examples to the relevant section of the Git Book.

What problem will this solve?

Negative refspecs are a fairly helpful tool for people whose upstream branches are not optimally named[^1]. It's a shame that the feature is not more widely covered.

[^1]: This isn't the user's fault. It's the project's fault.

Have you thought about other solutions?

Please feel totally free[^2] to lift, adapt, etc. the text from my Stack Overflow example if that's helpful.

[^2]: For the purposes of this project, any copyright I hold on that answer is waived.

Do you want to help with this enhancement idea?

Maybe Edit: Sure. See #2025

Lingua principale
CSS
Stelle
6.6k
Fork
2.1k
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Guida per i contributori

Apri la guida per i contributori

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 progit/progit2

Tutte le issue di progit/progit2

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.