• Kirill Smelkov's avatar
    NXD Teach GitLab about patches · b27dc77e
    Kirill Smelkov authored
    Teach GitLab not only to merge changes from a merge-request, but also to
    apply patches posted to merge-request in a way like `git am` would do -
    without merge commit and directly on top of current branch. Which way to
    go is selected by user in web UI, and apply patches is the first option.
    
    There are 3 cases:
    
    - only 1 commit is present in MR -> the only available option is to
      apply that single commit as one patch without a merge
    
      ( There is no need for merge commit in this case at all: information
        about user who applied the patch goes to "Committer" field in resultant
        commit. Avoiding 1 merge per 1 patch results in cleaner history )
    
      It is also possible to review patch description directly in web UI,
      before doing the actual application, and correct / amend it as needed.
    
    - several commits are present in MR:
    
      * it is possible to apply the patches directly on top of current
        branch. Again information about who applied what goes to "Committer"
        field.
    
      * it is possible to merge MR changes with making a merge commit.
    
        This variant is useful, when patches from a MR do several logical
        steps to reach one goal, and MR description contain cover letter for
        whole patch series.
    
        in this case original commits stay untouched and resulting merge
        will contain MR author as author, user who accepted MR as committer,
        and cover letter as merge commit message.
    
        NOTE we avoid useless "Merge branch X into Y" in merge message, and
            just put MR title into merge subject and MR description into merge
            description.
    
            This way it is more logical with more important information in
            merge subject and thus e.g. more handy to oversee what a merge brings,
            just by it subject, e.g. via looking at updates via
    
                gitk --first-parent ...
    
            or via web.
    
    NOTE for pre-generated references to merge-request we now use full MR
        URL, instead of !<MR-n>. Full URLs work everywhere, not only on
        original site where MR was created, or even only in original repo
        and not its fork on the same site.
    b27dc77e
repository.rb 25.7 KB