Development_workflow.md 2.15 KB
Newer Older
1 2 3 4 5 6
---
short-description: How we do it
...

# Development Workflow

7
We use [Gitlab](https://gitlab.gnome.org/GNOME/pitivi/issues) to track all
8 9 10 11 12 13 14 15
bugs and feature requests. Feel free to open a task if you have found a
bug or wish to see a feature implemented. If it already exists,
subscribe to it to keep yourself updated with its progress. You can also
subscribe to the entire project.

## Picking a task to work on

To get involved, you can start with tasks tagged [Pitivi tasks for
16
newcomers](https://gitlab.gnome.org/GNOME/pitivi/issues?label_name%5B%5D=4.+Newcomers).
17 18 19
It's best to get in touch with us on our IRC channel `#pitivi` on
Freenode, to see if it's still meaningful.

20
Once you decide, assign the task to yourself in GitLab.
21 22 23 24 25 26 27 28 29 30 31 32

## Fixing the task

Next is the fun part where you implement your cool feature, or fix an
annoying bug:


### Create a new git branch

Create a new branch with a relevant name in your local git repository.

```
33
$ git checkout -b feature_name origin/master
34 35 36 37 38 39 40 41 42 43 44 45 46 47
```

### Commit your changes

Once you have made your changes, commit them in your local git
repository. Follow the [GNOME
guidelines](https://wiki.gnome.org/Newcomers/CodeContributionWorkflow#Commit_guidelines)
for creating commits.

Be aware that when you create a commit, `pre-commit` is executed to
perform checks on the changes. In some cases it does some automatic
fixes – when this happens, make sure those are included in the commit you
want to create.

48
### Propose your patches
49

50 51 52
1. In the [GitLab UI](https://gitlab.gnome.org/GNOME/pitivi) press the "fork"
   button (*WARNING: Make sure to be authenticated otherwise the button won't be
   avalaible*)
53

54
2. Add the remote git repository you just forked as a remote to your local git repository:
55

56
    git remote add *yourgitlabusername* https://gitlab.gnome.org/yourgitlabusername/pitivi
57

58
3. Push your branch to your fork with:
59

60
    git push *yourgitlabusername*
61

62 63
4. Create merge request either by the link that shows in the command line after
   pushing or in the GitLab UI clicking "Create merge request" in your branch.
64

65 66
[Gitlab workflow for contribution]: https://gitlab.gnome.org/GNOME/pitivi/
[gitlab]: https://gitlab.gnome.org/GNOME/pitivi/