mail-templates: adjust text about git #11272

Merged
jnsamyak merged 3 commits from git-text into main 2026-06-08 03:10:59 +00:00
Contributor

The text is reflown to 79 columns.

Signed-off-by: Zbigniew Jędrzejewski-Szmek zbyszek@in.waw.pl

The text is reflown to 79 columns. Signed-off-by: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
First-time contributor

I'm happy to see git pull --rebase stop being suggested. It's a rather circuitous (and potentially dangerous) way to pick up a new remote branch. Thanks!

IMO, 79 columns is a bit wide for email. Ideally, mail is under 72 or so columns, to allow for others to quote it and still stay less than 80 columns.

But if re-flowing is desired, that seems better done in a separate commit, likely applied to all of the templates. And maybe a README in the templates dir which denotes the desired column-width?

I'm happy to see `git pull --rebase` stop being suggested. It's a rather circuitous (and potentially dangerous) way to pick up a new remote branch. Thanks! IMO, 79 columns is a bit wide for email. Ideally, mail is under 72 or so columns, to allow for others to quote it and still stay less than 80 columns. But if re-flowing is desired, that seems better done in a separate commit, likely applied to all of the templates. And maybe a README in the templates dir which denotes the desired column-width?
Contributor

The text is reflown to 79 columns.

This makes the change a tad hard to review. Could you please not mix that in the same commit?

> The text is reflown to 79 columns. This makes the change a tad hard to review. Could you please not mix that in the same commit?
Member

The reason we recommend git pull --rebase is so that anything stored locally gets replayed on top in the event that a commit was done by someone else (mass build and branching events usually include that). Since we don't have force pushes, this ensures that we don't break something or randomly introduce merge commits.

The reason we recommend `git pull --rebase` is so that anything stored locally gets replayed on top in the event that a commit was done by someone else (mass build and branching events usually include that). Since we don't have force pushes, this ensures that we don't break something or randomly introduce merge commits.
First-time contributor

The reason we recommend git pull --rebase is so that anything stored locally gets replayed on top in the event that a commit was done by someone else (mass build and branching events usually include that). Since we don't have force pushes, this ensures that we don't break something or randomly introduce merge commits.

That's not relevant in this case. No one is arguing that we should recommend git pull instead of git pull --rebase. Rather, git fetch is all that is needed to pick up the new branch, with no other side-effects.

And as I wrote on the devel list here, git pull uses --ff-only by default these days, which is generally better than starting with git pull --rebase for most users. But the arguments/options to git pull aren't the core issue here.

> The reason we recommend `git pull --rebase` is so that anything stored locally gets replayed on top in the event that a commit was done by someone else (mass build and branching events usually include that). Since we don't have force pushes, this ensures that we don't break something or randomly introduce merge commits. That's not relevant in this case. No one is arguing that we should recommend `git pull` instead of `git pull --rebase`. Rather, `git fetch` is all that is needed to pick up the new branch, with no other side-effects. And as I wrote on the devel list [here](https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/message/GIGM4225NUZ5YZHKHGXGHJKE4422IWBQ/), `git pull` uses `--ff-only` by default these days, which is generally better than starting with `git pull --rebase` for most users. But the arguments/options to `git pull` aren't the core issue here.
Author
Contributor

rebased onto bc444875265a104e6880023a76643acf80119274

rebased onto bc444875265a104e6880023a76643acf80119274
Author
Contributor

OK. I split this into three commits now:

  • the first one wraps the text to 72 characters.
  • the second one fixes various bits and pieces. It is separate to make review easier.
  • the third one has the actual change.
OK. I split this into three commits now: - the first one wraps the text to 72 characters. - the second one fixes various bits and pieces. It is separate to make review easier. - the third one has the actual change.
Author
Contributor

3 new commits added

  • mail-templates: adjust text about git
  • mail-templates: add missing punctuation and such
  • mail-templates: reflow text to 72 characters
**3 new commits added** * ``mail-templates: adjust text about git`` * ``mail-templates: add missing punctuation and such`` * ``mail-templates: reflow text to 72 characters``
First-time contributor

That looks great @zbyszek, thanks!

Very minor, there are a few stray characters in the commit body for the last commit:

'git pull --rebase' is a s a rather ...

s/ s a// :)

That looks great @zbyszek, thanks! Very minor, there are a few stray characters in the commit body for the last commit: > 'git pull --rebase' is a s a rather ... `s/ s a//` :)
Author
Contributor

3 new commits added

  • mail-templates: adjust text about git
  • mail-templates: add missing punctuation and such
  • mail-templates: reflow text to 72 characters
**3 new commits added** * ``mail-templates: adjust text about git`` * ``mail-templates: add missing punctuation and such`` * ``mail-templates: reflow text to 72 characters``
Author
Contributor

Update with just the commit message fix.

Update with just the commit message fix.
Contributor

Looks good, thanks!

Looks good, thanks!
Contributor

rebased onto 85827321087fe4bb64d4b94e2ab4aa3fc6afba9b

rebased onto 85827321087fe4bb64d4b94e2ab4aa3fc6afba9b
First-time contributor

The reason we recommend git pull --rebase is so that anything stored locally gets replayed on top in the event that a commit was done by someone else (mass build and branching events usually include that).

But what has that got to do with the creation of the f38 branch?

Rebasing your local commits when there are upstream changes by other packagers is just entirely normal dist-git workflow, and nothing to do with branching from rawhide. Why should this email about branching be the place for general "how to git" info?

Since we don't have force pushes, this ensures that we don't break something or randomly introduce merge commits.

If we don't want merge commits, we should add a pre-receive hook to reject them. This email about branching is not the place to enforce that policy.

> The reason we recommend `git pull --rebase` is so that anything stored locally gets replayed on top in the event that a commit was done by someone else (mass build and branching events usually include that). But what has that got to do with the creation of the `f38` branch? Rebasing your local commits when there are upstream changes by other packagers is just entirely normal dist-git workflow, and nothing to do with branching from rawhide. Why should *this* email about branching be the place for general "how to git" info? > Since we don't have force pushes, this ensures that we don't break something or randomly introduce merge commits. If we don't want merge commits, we should add a pre-receive hook to reject them. This email about branching is not the place to enforce that policy.
First-time contributor

Should "pending updates will be pushed ..." start a new sentence?

Should "pending updates will be pushed ..." start a new sentence?
First-time contributor

Can we avoid the "it'll" contraction and just say "it will appear"?

Can we avoid the "it'll" contraction and just say "it will appear"?
Author
Contributor

rebased onto bc444875265a104e6880023a76643acf80119274

rebased onto bc444875265a104e6880023a76643acf80119274
Author
Contributor

Updated with those two changes.

Updated with those two changes.
Owner

ok, is everyone happy with the current version? Shall we merge?

ok, is everyone happy with the current version? Shall we merge?
Author
Contributor

Rebased again.

Rebased again.
Author
Contributor

rebased onto f4acef86ca

rebased onto f4acef86ca60eae3c0a11a619a89d09f0989cf94
Contributor

Pull-Request has been merged by churchyard

Pull-Request has been merged by churchyard
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
6 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
releng/tickets!11272
No description provided.