# Git Workflow

## Repository

De broncode van Chamilo wordt gehost op GitHub: [github.com/chamilo/chamilo-lms](https://github.com/chamilo/chamilo-lms)

## Branching

* **`master`** — Hoofdontwikkelbranch
* Feature-branches worden gemaakt vanuit `master` voor nieuwe ontwikkelingen
* Release-branches worden gemaakt voor stabiele releases

## Een wijziging bijdragen

1. **Fork** de repository op GitHub
2. **Kloon** je fork lokaal
3. **Maak een branch** voor je wijziging: `git checkout -b feature/my-feature`
4. **Voer je wijzigingen door** volgens de coderingsconventies
5. **Commit** met duidelijke, beschrijvende commitberichten
6. **Push** naar je fork: `git push origin feature/my-feature`
7. **Maak een pull request** aan tegen de `master`-branch

## Commitberichten

Schrijf duidelijke commitberichten die uitleggen **wat** en **waarom**:

```
Glossary: Voeg AI-ondersteunde termgeneratie toe

Docenten kunnen nu glossariumtermen genereren met behulp van geconfigureerde AI-providers. Ondersteunt configureerbare prompts en aantal termen.
```

### Conventie voor toolprefix

De onderwerpregel begint met de **tool of het gebied** dat door de wijziging wordt beïnvloed, gevolgd door een dubbele punt. We gebruiken een korte, gedeelde terminologie zodat de changelog en `git log --oneline` snel per tool kunnen worden doorlopen. Het prefix is altijd de **enkelvoudsvorm** van de canonieke naam van de tool.

Formaat: `<Prefix>: <Samenvatting in gebiedende wijs in de tegenwoordige tijd>`

Voorbeelden:

```
Document: Herstel lijstweergave voor studenten
Exercise: Voorkom dubbele vraagtitels binnen een quiz
Learnpath: Sta het herschikken van hoofdstukken toe via slepen en neerzetten
Internal: Refactor ResourceNode-hydratatie in de API-normalizer
CI: Cache Composer-downloads in de GitHub Actions-workflow
```

Als een wijziging meerdere tools omvat, kies dan de tool die het meest wordt beïnvloed; echt allesomvattende wijzigingen die alleen de codestructuur raken (geen eindgebruikerstool) vallen onder `Internal`. Wijzigingen die alleen documentatie betreffen (deze site, de changelog, inline docblocks die puur als referentie dienen) vallen onder `Documentation`.

***

#### Toegestane voorvoegsels

| Voorvoegsel          | Bereik / opmerkingen                                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------------ |
| `Admin`              |                                                                                                        |
| `Announcement`       |                                                                                                        |
| `Attendance`         |                                                                                                        |
| `Authentication`     |                                                                                                        |
| `Blog`               |                                                                                                        |
| `Calendar`           | Niet "Agenda"                                                                                          |
| `Career`             |                                                                                                        |
| `Catalogue`          | Cursus- en sessiecatalogus, inclusief "populaire cursussen" op de homepage                             |
| `Chat`               |                                                                                                        |
| `CI`                 | Continuous Integration, geautomatiseerde tests, enz.                                                   |
| `Course description` |                                                                                                        |
| `Course Progress`    | Niet "Thematische vooruitgang"                                                                         |
| `Course settings`    |                                                                                                        |
| `Cron`               |                                                                                                        |
| `Dashboard`          |                                                                                                        |
| `Display`            |                                                                                                        |
| `Document`           |                                                                                                        |
| `Documentation`      | Alles wat uitsluitend betrekking heeft op het documenteren van Chamilo of de code, het changelog, enz. |
| `Dropbox`            |                                                                                                        |
| `Exercise`           | Niet "Quiz"                                                                                            |
| `Extra Fields`       |                                                                                                        |
| `Forum`              |                                                                                                        |
| `Glossary`           |                                                                                                        |
| `Gradebook`          | Inclusief certificaten                                                                                 |
| `Group`              | Inclusief cursusgroepen, globale groepen en klassen                                                    |
| `Help`               |                                                                                                        |
| `Hook`               | Voor het interne hook-mechanisme                                                                       |
| `Install`            | Inclusief upgrade-zaken                                                                                |
| `Internal`           | Voor wijzigingen en fixes die voornamelijk de code zelf beïnvloeden of zeer globaal van aard zijn      |
| `Language`           |                                                                                                        |
| `Link`               |                                                                                                        |
| `Learnpath`          | Voor LP / Leertrajecten                                                                                |
| `Maintenance`        | Het cursusonderhoudsgereedschap: cursus kopieën, back-up, herstel, enz.                                |
| `Message`            |                                                                                                        |
| `Notebook`           |                                                                                                        |
| `Optimization`       |                                                                                                        |
| `Portfolio`          |                                                                                                        |
| `Privacy`            |                                                                                                        |
| `Script`             | Voor wat zich bevindt in `tests/scripts/`                                                              |
| `Search`             | Volledige tekstzoekopdracht                                                                            |
| `Security`           |                                                                                                        |
| `Session`            |                                                                                                        |
| `Skill`              |                                                                                                        |
| `Social`             | Sociaal netwerk                                                                                        |
| `SSO`                | Single Sign-On methoden                                                                                |
| `Survey`             |                                                                                                        |
| `System`             | Dingen die voornamelijk te maken hebben met hosting en fijn-tuning op serverniveau                     |
| `Template`           |                                                                                                        |
| `Ticket`             |                                                                                                        |
| `Tracking`           |                                                                                                        |
| `User`               |                                                                                                        |
| `Webservice`         |                                                                                                        |
| `Wiki`               |                                                                                                        |
| `Work`               |                                                                                                        |
| `WYSIWYG`            |                                                                                                        |
| `XAPI`               |                                                                                                        |

***

## Codebeoordeling

Pull requests worden beoordeeld door het onderhoudsteam. Wees voorbereid om:

* Feedback te verwerken en aanpassingen te doen
* Je branch up-to-date te houden met `master`
* Ervoor te zorgen dat tests slagen

## Problemen Melden

Meld bugs en functie-aanvragen op de GitHub issue tracker.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-nl/ontwikkelaarsgids/developer-guide/contributing/git-workflow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.