# Comment contribuer

A l'image des deux environnements qu'il propose aux joueurs/stagiaires avec le jeu icaRius d'une part et le grimoire IGoR d'autre part, le projet Funcamp-R comporte deux volets pour lesquels il est possible de contribuer :

* le code source du jeu icaRius, développé avec le moteur Solarus
* le code source des tutoriels R, regroupés sous la forme d'un package.

Pour porter ces environnements en mode Cloud, chaque volet est par ailleurs orchestré par un système de containers docker :

* le jeu icaRius est empaquetté dans une image virtuelle d'un Ubuntu dans lequel le moteur de jeu Solarus a été pré-installé, puis est proposé en accès web via une interface Vnc
* le grimoire IGoR est empaquetté dans une image virtuelle d'un serveur R-Shiny, enrichi de l'ensemble des dépendances nécessaires pour faire fonctionner les tutoriels, en particulier les packages Learnr et Parsons.

Enfin, le site documentaire que vous consultez actuellement est réalisé avec Gitbook.

Toutes les ressources sont structurées sous forme de dépôts dans le compte Github InseeFrLab, à l'adresse <https://github.com/InseeFrLab>. Y figurent les dépôts suivants :

* funcamp-r : site documentaire présentant le projet.&#x20;
* funcamp-r-grimoire : le code-source pour le package R correspondant au grimoire avec l'ensemble des tutoriels. Ce package a été réalisé avec l'appui précieux et apprécié (au moins 50 rubis à la mode icarius) de la société ThinkR.
* funcamp-r-dock : système d'orchestration docker du package pour proposer de suivre en ligne les tutoriels. Ce dispositif a été réalisé avec l'expertise magique de la société ThinkR et de la division Innovation et instruction technique de l'Insee.
* funcamp-r-neverending : dernier chapitre du grimoire, correspondant à un environnement R-studio avec un projet associé, avec édition simplifié de Rmd (utilisation de xaringan). Ecrit avec la plume de la société ThinkR.
* funcamp-r-icarius : le code source du jeu, correspondant à une "quête" développée dans le moteur de jeu Solarus.&#x20;
* funcamp-r-ubuntu-solarus : système d'orchestration docker du jeu pour proposer une expérience en mode Cloud. Ce dispositif a été réalisé avec l'aide inextinguible (> 10 coeurs) de la division Innovation et instruction technique de l'Insee.
* funcamp-r-windows-solarus : mise à disposition du runner Solarus et de la quête icaRius, pour l'environnement Windows. Téléchargeable et installable en mode portable sur une clé USB
* funcamp-r-windows-grimoire-launcher : dispositif d'empaquettage de l'ensemble des ressources - vidéoludiques et pédagogiques - pour suivre le funcamp en mode portable,  en installant ces ressources sur une clé USB pour un poste windows. Un frontend est inclus pour permettre au stagiaire de lancer facilement chaque étape du funcamp.

Vous souhaitez contribuer ? Proposer une amélioration ou correction sous forme d'issue ? Rendez-vous sur l'un des espaces concernés :&#x20;

| Repository                                                                                               | Description                                                                                                   |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [funcamp-r-grimoire](https://github.com/InseeFrLab/funcamp-r-grimoire)                                   | R (learnr) tutorials                                                                                          |
| [funcamp-r-dock](https://github.com/InseeFrLab/funcamp-r-dock)                                           | Base docker image for learnr tutorials                                                                        |
| [funcamp-r-neverending](https://github.com/InseeFrLab/funcamp-r-neverending)                             | Last chapter                                                                                                  |
| [funcamp-r-icarius](https://github.com/InseeFrLab/funcamp-r-icarius)                                     | Serious game (requires the [Solarus Game Engine](https://www.solarus-games.org/))                             |
| [funcamp-r-ubuntu-solarus](https://github.com/InseeFrLab/funcamp-r-ubuntu-solarus)                       | Docker image of `ubuntu-desktop-lxde-vnc` including the [Solarus Game Engine](https://www.solarus-games.org/) |
| [funcamp-r-windows-solarus](https://github.com/InseeFrLab/funcamp-r-windows-solarus)                     | Zip archive to run the icaRius game on Windows                                                                |
| [funcamp-r-windows-grimoire-launcher](https://github.com/InseeFrLab/funcamp-r-windows-grimoire-launcher) | Ressources to set up a local drive with all the resources for Windows                                         |


---

# 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.funcamp.sspcloud.fr/espace-contributeur/comment-contribuer.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.
