Bug 264080 - In Committer's Guide section 5.3, use Git-to-Git for how-to-MFC examples instead of/together with SVN-to-Git
Summary: In Committer's Guide section 5.3, use Git-to-Git for how-to-MFC examples inst...
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Sergio Carlavilla Delgado
URL: https://docs.freebsd.org/en/articles/...
Keywords: needs-patch
Depends on:
Blocks:
 
Reported: 2022-05-19 12:45 UTC by Pau Amma
Modified: 2023-07-29 05:49 UTC (History)
4 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Pau Amma 2022-05-19 12:45:01 UTC
13 to 17 months (depending on the repo) after the switch to git, it's increasingly likely that any change needing MFC'ing will be originally a git commit, not a svn commit. (Or keep both set of examples, if svn-to-git is still useful eg for ooops-forgot-to-MFC cases.)
Comment 1 Fernando Apesteguía freebsd_committer freebsd_triage 2022-10-09 16:10:27 UTC
^Triage: reporter is committer, assign accordingly.
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2023-04-01 15:55:01 UTC
Before I became aware of this bug report, I stumbled across the subheading that has no subtext. 

D39384 intends to hide the subheading whilst this report is open.
Comment 3 commit-hook freebsd_committer freebsd_triage 2023-04-02 13:20:50 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=55ac45c72c7e8356095503e8f10d1c6c4a8798d0

commit 55ac45c72c7e8356095503e8f10d1c6c4a8798d0
Author:     Graham Perrin <grahamperrin@FreeBSD.org>
AuthorDate: 2023-04-02 13:12:39 +0000
Commit:     Graham Perrin <grahamperrin@FreeBSD.org>
CommitDate: 2023-04-02 13:12:39 +0000

    Committer's Guide … Git … MFC … Examples: none

    The 'Examples' subheading that is currently at
    https://docs.freebsd.org/en/articles/committers-guide/#_examples
    has no subtext.

    Hiding the subheading was considered. Instead, it is deleted.

    https://bugs.freebsd.org/264080

    PR:                      264080
    Approved by:             imp
    Differential Revision:   https://reviews.freebsd.org/D39384

 documentation/content/en/articles/committers-guide/_index.adoc | 2 --
 1 file changed, 2 deletions(-)
Comment 4 Graham Perrin freebsd_committer freebsd_triage 2023-04-02 13:39:38 UTC
Looking ahead, from <https://reviews.freebsd.org/D39384#896487>: 

> … Re-reading the MFC section, it needs to be updated based on the 
> last 18-24 months of what we've actually done with MFCs

----

Triage: 

* clear the maintainer-feedback flag that lacks an addressee

* 5.3.10 no longer exists, so edit the URL field

* the closest anchor below 5.4 (currently 'Vendor Imports with Git') is 
  <https://docs.freebsd.org/en/articles/committers-guide/#_trim_metadata>.
Comment 5 Graham Perrin freebsd_committer freebsd_triage 2023-05-19 00:53:33 UTC
(In reply to commit-hook from comment #3)

For clarity: <https://cgit.freebsd.org/doc/commit/documentation/content/en/articles/committers-guide/_index.adoc?id=c7527916ede4e8f16d837c65f16d6e9404568b23> (2023-02-21) removed examples, 

> git-primer: Trim old subversion info