Contribuer

Un projet open source, c'est une équipe qui grandit.

Pas de pression
LScript est un projet bénévole. Toute contribution, grande ou petite, est précieuse. Vous n'avez pas besoin d'être expert pour aider.

Comment contribuer ?

📝

Documentation

Améliorez le guide, corrigez des fautes, ajoutez des exemples. Pas besoin de coder.

  • Clarifier une explication
  • Traduire en d'autres langues
  • Ajouter des tutoriels
🐛

Signaler des bugs

Vous avez trouvé un comportement inattendu ? Dites-le nous.

  • Décrivez ce que vous avez fait
  • Ce que vous attendiez
  • Ce qui s'est passé
💡

Proposer des idées

Une fonctionnalité qui manque ? Une amélioration possible ?

  • Ouvrez une issue GitHub
  • Expliquez le besoin
  • Discutons ensemble
🛠️

Écrire du code

Corrigez un bug, ajoutez une fonction, améliorez le LSP.

  • Fork le projet
  • Créez une branche
  • Soumettez une PR
🧪

Tester

Utilisez LScript et dites-nous ce qui fonctionne ou non.

  • Essayez les nouvelles versions
  • Testez sur différents OS
  • Partagez vos retours
📢

Parler de LScript

La meilleure contribution est parfois le bouche-à-oreille.

  • Partagez avec des enseignants
  • Écrivez un article
  • Mentionnez-nous sur les réseaux

Première contribution

1

Fork le projet

Cliquez sur "Fork" sur la page GitHub du projet.

2

Clonez votre fork

git clone https://github.com/VOTRE-USERNAME/Lscript.git
cd Lscript
3

Créez une branche

git checkout -b ma-contribution
4

Faites vos modifications

Éditez les fichiers, testez, commitez.

5

Soumettez une Pull Request

Retournez sur GitHub et créez une PR vers le repo principal.

Code de conduite

LScript est un espace accueillant. Nous attendons de tous les participants qu'ils :

🤝

Soient respectueux — Pas d'insultes, pas de mépris. On peut être en désaccord poliment.

🌍

Soient inclusifs — Tout le monde est bienvenu, quel que soit son niveau ou son origine.

🎓

Soient pédagogues — Expliquez plutôt que de critiquer. Nous apprenons tous.

💬

Communiquent clairement — Les issues et PR claires font gagner du temps à tout le monde.

Structure du projet

lscript/

Le cœur du langage : lexer, parser, transpiler Python.

lscript-lsp/

Le Language Server Protocol : diagnostics, completion, hover.

lscript-vscode/

L'extension VS Code : syntaxe, snippets, intégration LSP.

docs/

La documentation Markdown : guide, grammaire, spécification.

examples/

Les exemples de programmes LScript.

website/

Ce site web que vous lisez actuellement.

Prêt à contribuer ?

Commencez par explorer le code ou ouvrir une issue.