Difference between revisions of "Creating a Samba patch series"

From SambaWiki
Line 10: Line 10:
   
 
Each git commit should be succinct and only do one thing. The problem with merge requests is that the '''Changes''' view shows a complete product, but in Samba, we also care about the history when getting to the final product.
 
Each git commit should be succinct and only do one thing. The problem with merge requests is that the '''Changes''' view shows a complete product, but in Samba, we also care about the history when getting to the final product.
  +
  +
== Examples ==
  +
  +
=== What not to do ===
  +
  +
Here is an actual example from an open source project (identifying information has been removed), of a poorly created merge request:
  +
  +
[[File:Github_mr_1.png]]
  +
  +
[[File:Github_mr_2.png]]
  +
  +
This request contains '''47''' commits, the merge request title does not explain what the code change is doing, and the final result is a single line code change!

Revision as of 18:23, 15 June 2020

Introduction

When contributing to Samba, there are quality expectations that need to be met in order for your patches to be accepted. Please review these guidelines before writing your first commits, otherwise you may need to rebase your patches.

What this page is not

This page is not meant to be a technical overview about using git, there are already plenty of resources for learning to use git. It's expected when you reach this page that you already know these concepts.

What a commit should include

Each git commit should be succinct and only do one thing. The problem with merge requests is that the Changes view shows a complete product, but in Samba, we also care about the history when getting to the final product.

Examples

What not to do

Here is an actual example from an open source project (identifying information has been removed), of a poorly created merge request:

Github mr 1.png

Github mr 2.png

This request contains 47 commits, the merge request title does not explain what the code change is doing, and the final result is a single line code change!