> For the complete documentation index, see [llms.txt](https://openfab.gitbook.io/rtfm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openfab.gitbook.io/rtfm/github/101-github/102-issues.md).

# 102 Issues

## How to participate to a project

> “Always start with an issue” says Job, VP of Product here at GitLab. Before you begin anything else, summarize your ideas in an issue and share it. It’s such a simple rule, but the impact is huge.

Issues can have endless applications. Just to exemplify, these are some cases for which creating issues are most used:

* Discussing the implementation of a new idea
* Submitting feature proposals
* Asking questions
* Reporting bugs and malfunction
* Obtaining support

  **Homework:**
* Start by watching this: [1.4: GitHub Issues - Git and GitHub for Poets](https://www.youtube.com/watch?v=WMykv2ZMyEQ)
* Then let's check that: You can start by browsing issues from **Openfab-lab/openfab** repository, here: <https://github.com/openfab-lab/openfab/issues>

![capture](https://user-images.githubusercontent.com/12049360/50055483-eb1b7480-014f-11e9-992d-7719e489cd23.JPG)

1. You can post a comment to react on any issues, simply look for this at the end of page:\
   ![image](https://user-images.githubusercontent.com/12049360/50149717-3e123a80-02bc-11e9-8cc8-aa4004cc8eb1.png)
2. To finish, just create your own issue to present yourself. ![image](https://user-images.githubusercontent.com/12049360/50149106-91838900-02ba-11e9-99e0-ac55fd3fc080.png)

It's always nice to let the community know a bit more about you, explain a bit why you want to join and on what you want to help.

When creating an new issues, there is a template in place to help you organize your thought. Like that:

```
Please use this format, which is intended to keep things simple and focused

The point is to make the Issue well-defined for everyone involved: 
- it identifies the audience and context (or user), 
- the problem or outcome wished. (or goal)
- the action (or task), and in some case,
- the outcome of a win/win situation (or Result/reward) as simply as possible.

this part is to be deleted when first edit... 

---

- [ ] ref to file .md or pullRequest #: .................................................  
*(to be edited when resolved)*

## context
## objectif
## proposition
## Results?
```