> For the complete documentation index, see [llms.txt](https://guide.crownicles.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.crownicles.com/aidez-nous-a-developper-crownicles/comment-contribuer/redaction-traduction-du-guide.md).

# Rédaction / Traduction du guide

Nous utilisons exclusivement [GitBook](https://app.gitbook.com/o/-MH1_FERaV0tsl55ERgC/s/-MH1fCvNZ7zikrWd7dJj-2584506019/) pour la rédaction du guide (les pull requests sur le dépôt github du guide ne seront pas prises en compte).

Toutes les infos nécessaires sont accessibles via [le serveur Discord](https://discord.com/invite/crownicles) du bot. Il vous faudra vous rendre dans le channel `#infos-grades` et demander le rôle `@Wiki`. Ceci vous permettra d'accéder au channel `#wiki` où sont échangées toutes les informations relatives au guide et à sa rédaction.

Le lien permettant d'accéder au projet GitBook et de commencer à proposer vos améliorations est épinglé dans le channel `#wiki`.

### Créer une change request

Une fois l'accès au projet GitBook obtenu, commencez par cliquer sur le bouton Edit (en haut à droite) pour créer une change request :

<div align="center"><img src="https://2159345893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MH1fCvNZ7zikrWd7dJj-2584506019%2Fuploads%2FCknyVOGEznVkxeZHGFPs%2Fchange_request.png?alt=media&amp;token=93892ad1-8ecf-4ac2-a2ca-36aa53cc8ba1" alt="Le bouton Edit permettant de créer une change request"></div>

Donnez ensuite un nom à votre change request :

![Ce nom doit correspondre à la nature de vos modifications](https://2159345893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MH1fCvNZ7zikrWd7dJj-2584506019%2Fuploads%2FU0jCpsnQyk6hyzU8TcS5%2Fimage.png?alt=media\&token=d7973046-67cd-4f43-9a91-bfd673229ca6)

Vous pouvez alors faire vos modifications sur la ou les pages de votre choix.

### Soumettre une change request

Lorsque votre Change Request est prête, il suffit de la soumettre à une revue en cliquant sur le bouton Submit for review (en bas à droite) :

![Le bouton Submit permettant de valider une change request](https://2159345893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MH1fCvNZ7zikrWd7dJj-2584506019%2Fuploads%2F3ZniB09AfVC8HvKkcjy9%2Fimage.png?alt=media\&token=2e65d85e-e2b5-4722-833e-e554099bb2c2)

Elle sera alors analysée par un relecteur dès que l'un d'entre eux en aura le temps. Il pourra soit la valider directement soit vous faire des remarques via les commentaires concernant les retouches qu'il estime nécessaires.

### Documentation GitBook

Si besoin, la documentation complète de l'outil GitBook est accessible à l'adresse <https://docs.gitbook.com> (en anglais uniquement).

### Traduction du guide

Pour la traduction, rien de plus simple ! Il suffit de faire exactement comme pour la rédaction mais en cliquant sur le wiki [english](https://app.gitbook.com/o/-MH1_FERaV0tsl55ERgC/home) !


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://guide.crownicles.com/aidez-nous-a-developper-crownicles/comment-contribuer/redaction-traduction-du-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
