Add negative refspec examples to 10.5 Git Internals - The Refspec

Aberta Para iniciantes
#1,816 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

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

Direção de pesquisa

Comece pela seção “10.5 Git Internals - The Refspec” do Git Book vinculada na issue e, em seguida, compare a documentação de pull-fetch vinculada e o exemplo do Stack Overflow. Adicione um subtítulo e/ou exemplos de refspecs negativos que expliquem o recurso nessa seção. O trabalho estará concluído quando o capítulo abranger claramente os marcadores de refspecs negativos e a documentação for compilada com sucesso.

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

Descrição

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

Linguagem predominante
CSS
Estrelas
6.6k
Forks
2.1k
Nenhum PR com merge em 30d

Guia de contribuição

Abrir o guia de contribuição

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

Todas as issues de progit/progit2

Issues semelhantes

Mais issues de Documentation

Receba novas issues na sua caixa de entrada

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