Create git_for_non_developers.bb
This commit is contained in:
parent
9ee7d60afe
commit
b0ec0e9eac
73
doc/fr/git_for_non_developers.bb
Normal file
73
doc/fr/git_for_non_developers.bb
Normal file
@ -0,0 +1,73 @@
|
||||
[b]Git pour les non développeurs[/b]
|
||||
|
||||
Bon vous traduivez ou contribuez à un thème et chaque fois que vous faites un pull request, vous devez parler avec un des développeurs avant que vos changements soient pris en compte.
|
||||
|
||||
Vous devez trouver un petit tutorial pour vous aider à maintenair les choses synchronisé. C'est trés facile
|
||||
|
||||
|
||||
|
||||
After you've created a fork of the repo (just click "fork" at github), you need to clone your own copy.
|
||||
|
||||
For the sake of examples, we'll assume you're working on a theme called redexample (which does not exist).
|
||||
|
||||
[code]git clone https://github.com/username/red.git[/code]
|
||||
|
||||
Once you've done that, cd into the directory, and add an upstream.
|
||||
|
||||
[code]
|
||||
cd red
|
||||
git remote add upstream https://github.com/redmatrix/redmatrix
|
||||
[/code]
|
||||
|
||||
From now on, you can pull upstream changes with the command
|
||||
[code]git fetch upstream[/code]
|
||||
|
||||
Before your changes can be merged automatically, you will often need to merge upstream changes.
|
||||
|
||||
[code]
|
||||
git merge upstream/master
|
||||
[/code]
|
||||
|
||||
You should always merge upstream before pushing any changes, and [i]must[/i] merge upstream with any pull requests to make them automatically mergeable.
|
||||
|
||||
99% of the time, this will all go well. The only time it won't is if somebody else has been editing the same files as you - and often, only if they have been editing the same lines of the same files. If that happens, that would be a good time to request help until you get the hang of handling your own merge conflicts.
|
||||
|
||||
Then you just need to add your changes [code]git add view/theme/redexample/[/code]
|
||||
|
||||
This will add all the files in view/theme/redexample and any subdirectories. If your particular files are mixed throughout the code, you should add one at a time. Try not to do git add -a, as this will add everything, including temporary files (we mostly, but not always catch those with a .gitignore) and any local changes you have, but did not intend to commit.
|
||||
|
||||
Once you have added all the files you have changed, you need to commit them. [code]git commit[/code]
|
||||
|
||||
This will open up an editor where you can describe the changes you have made. Save this file, and exit the editor.
|
||||
|
||||
Finally, push the changes to your own git
|
||||
[code]git push[/code]
|
||||
|
||||
And that's it, your repo is up to date!
|
||||
|
||||
All you need to do now is actually create the pull request. There are two ways to do this.
|
||||
|
||||
The easy way, if you're using Github is to simply click the green button at the top of your own copy of the repository, enter a description of the changes, and click 'create pull request'. The
|
||||
main repository, themes, and addons all have their main branch at Github, so this method can be used most of the time.
|
||||
|
||||
Most people can stop here.
|
||||
|
||||
Some projects in the extended RedMatrix ecosphere have no Github presence, to pull request these is a bit different - you'll have to create your pull request manually. Fortunately, this isn't
|
||||
much harder.
|
||||
|
||||
[code]git request-pull -p <start> <url>[/code]
|
||||
|
||||
Start is the name of a commit to start at. This must exist upstream. Normally, you just want master.
|
||||
|
||||
URL is the URL of [i]your[/i] repo.
|
||||
|
||||
One can also specify <end>. This defaults to HEAD.
|
||||
|
||||
Example:
|
||||
[code]
|
||||
git request-pull master https://example.com/project
|
||||
[/code]
|
||||
|
||||
And simply send the output to the project maintainer.
|
||||
|
||||
#include doc/macros/main_footer.bb;
|
Reference in New Issue
Block a user