From 4d98bbdfa502cd525c9f8249e1d750d74a8226e8 Mon Sep 17 00:00:00 2001 From: Stefan Paquay Date: Mon, 2 Jan 2017 18:08:14 +0100 Subject: [PATCH] Almost done with the tutorial now --- doc/src/JPG/tutorial_new_pull_request.png | Bin 0 -> 19578 bytes doc/src/tutorial_github.txt | 96 +++++++++++++++++++++- 2 files changed, 93 insertions(+), 3 deletions(-) create mode 100644 doc/src/JPG/tutorial_new_pull_request.png diff --git a/doc/src/JPG/tutorial_new_pull_request.png b/doc/src/JPG/tutorial_new_pull_request.png new file mode 100644 index 0000000000000000000000000000000000000000..c442282c817a632b577322a23ceea7c53953bfab GIT binary patch literal 19578 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
    j^P%lfWQv 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 literal 0 HcmV?d00001 diff --git a/doc/src/tutorial_github.txt b/doc/src/tutorial_github.txt index f73f74b584..c2c064e949 100644 --- a/doc/src/tutorial_github.txt +++ b/doc/src/tutorial_github.txt @@ -106,7 +106,7 @@ unrelated feature, you should switch branches! After everything is done, add the files to the branch and commit them: - $ git add doc/src/tutorial_github.txt :pre + $ git add doc/src/tutorial_github.txt $ git add doc/src/JPG/tutorial_*.png :pre [Warning] @@ -131,8 +131,13 @@ After the commit, the changes can be pushed to the same branch on GitHub: $ git push :pre Git will ask you for your user name and password on GitHub if you have -not configured anything. If you correctly type your user name and -password, the change should be added to your fork on GitHub. +not configured anything. If your local branch is not present on Github yet, +it will ask you to add it by running + + $ git push --set-upstream origin github-tutorial-update :pre + +If you correctly type your user name and +password, the feature branch should be added to your fork on GitHub. If you want to make really sure you push to the right repository (which is good practice), you can provide it explicitly: @@ -143,3 +148,88 @@ or using an explicit URL: $ git push git@github.com:Pakketeretet2/lammps.git :pre +[Filing a pull request] +Up to this point in the tutorial, all changes were to {your} clones of LAMMPS. +Eventually, however, you want this feature to be included again upstream. +To do this, you will want to file a pull request by clicking on the +"New pull request" button: + +:c,image(JPG/tutorial_new_pull_request.png) + +Make sure that the current branch is set to the correct one, which, in +this case, is "github-tutorial-update". If done correctly, the only +changes you will see are those that were made on this branch. + +This will open up a new window that lists changes made to the +repository. If you are just adding new files, there is not much to do, +but I suppose merge conflicts are to be resolved here if there are +changes in existing files. If all changes can automatically be merged, +green text at the top will say so and you can click the "Create pull +request" button, see image. + +:c,image(JPG/tutorial_create_new_pull_request1.png) + +After this you have to specify a short title and a comment with +details about your pull request. I guess here you write what your +modifications do and why they should be incorporated upstream. After +that, click the "Create pull request" button, see image below. + +:c,image(JPG/tutorial_create_new_pull_request2.png) + +Now just write some nice comments, click "Comment", and that is it. It +is now up to the maintainer(s) of the upstream repository to +incorporate the changes into the repository and to close the pull +request. + +:c,image(JPG/tutorial_create_new_pull_request3.png) + +:line + +[Additional changes] + +Before the pull request is accepted, any additional changes you push +into your repository will automatically become part of the pull +request. + +:line + +[After a merge] + +When everything is fine the feature branch is merged into the LAMMPS +repositories: + +:c,image(JPG/tutorial_merged.png) + +Now one question remains: What to do with the feature branch that got +merged into upstream? + +It is in principle safe to delete them from your own fork. This helps +keep it a bit more tidy. Note that you first have to switch to another +branch! + +$ git checkout master +$ git pull master +$ git branch -d github-tutorial-update :pre + +If you do not pull first, it is not really a problem but git will warn +you at the next statement that you are deleting a local branch that +was not yet fully merged into HEAD. This is because git does not yet +know your branch just got merged into lammps-icms upstream. If you +first delete and then pull, everything should still be fine. + +Finally, if you delete the branch locally, you might want to push this +to your remote(s) as well: + +$ git push origin :github-tutorial-update :pre + +[Recent changes in the workflow] + +Some changes to the workflow are not captured in this tutorial. +For example, in addition to the master branch, to which all +new features should be submitted, there is now also an "unstable" +and a "stable" branch. Furthermore, the naming of the patches +now follow the pattern "patch_" so simplify +comparisons between releases. +Finally, all patches and submissions are subject to automatic +testing and code checks to make sure they at the very least +compile.