# Assign task to yourself (milestones, issues)

In a repository, team members can define Milestones and Issues. Milestones are used to track the overall progress of the project to make sure that deadlines are met. A milestone can group many issues, which are individual tasks that need to be finished in order to reach the milestone.

An issue is built up of the following attributes:
- the title, this should just be a quick description of the task 
- a label, to assign a category to the task such as: new content
- an assignee, the person who created the task can assign a team-member to the task or the task can remain without an assignee. Then whoever would like to pick up the task can assign it to themselves!
- a discussion section, here team-members can discuss any questions about the task
- a due date, in case the task is urgent or to keep track of deadlines

Every team member can create issues when they think of a task that would improve the book.

**Make and assign task to yourself (issues) in ...**

`````{tab-set}
````{tab-item} ... GitLab

The issues in GitLab can be found in your repositery in the left bar. 

![issues](figures/issues_new.png)

You can create an issue by clicking on the blue `New Issue` button in the top right corner. <br>
This will lead you to this window where you can specify all attributes we mentioned before!

![new issue](figures/New_Issue_GitLab.png)

````

````{tab-item} ... GitHub

The issues in GitHub can be found in your repositery in the top bar.


<figure align="center">
    <img src="figures/Issue_GitHub.PNG" alt="Example Image" width="650">
</figure>

Clicking on `Issues` will open up the page with all the issues on this repositery.

<figure align="center">
    <img src="figures/New_Issue_GitHub.PNG" alt="Example Image" width="650">
</figure>

Finally, by clicking the green `New Issue` button you can create a new issue and specify all the attributes we mentioned before!

<figure align="center">
    <img src="figures/New_Issue_GitHub2.PNG" alt="Example Image" width="650">
</figure>

```{Note}

The follwing steps explain how to create a branch from a new issue. By doing this you can create most of the steps described in the section called [branching](branches.md). However, if you are unfamiliar with the term make sure to still read the section to understand the function.
```
After creating the issue, the description of the issue will automatically open. On the bottom left there is an option `create a branch` (in yellow) from this issue. This will create a new branch in the repositery which you can use to solve the issue. 

<figure align="center">
    <img src="figures/New_Issue_GitHub3.PNG" alt="Example Image" width="650">
</figure>

Clicking on `create a branch` will open the following window in which you can specify the name and the repositery.

<figure align="center">
    <img src="figures/New_Issue_GitHub4.PNG" alt="Example Image" width="350">
</figure>
````
`````

When the task is completed, the issue can be closed and you can move on to the next!