Sommaire
1. Démarrer : compte et connexion
Créez un compte depuis Rejoindre Palabre avec votre e-mail, ou connectez-vous depuis Se connecter. Une connexion directe avec GitHub est prévue dans l'interface ; elle nécessite qu'un identifiant d'application OAuth GitHub soit configuré côté serveur par l'administrateur de l'instance — sans cela, utilisez l'e-mail.
Une fois connecté, complétez votre profil (stack, niveau, pays, bio) depuis Paramètres : c'est ce qui vous rend visible dans l'annuaire des développeurs et dans les recommandations de mentors ou de coéquipiers.
2. Trouver ou créer une salle
Une salle est l'espace de collaboration central de Palabre : un groupe de développeurs qui travaillent ensemble sur un même sujet ou projet. Parcourez les salles publiques depuis votre tableau de bord, ou créez-en une nouvelle en indiquant un nom, une stack et une visibilité (publique ou privée).
Chaque salle a des rôles : hôte et co-hôte (création/administration, accès aux secrets et à la clôture des votes), membre (participation complète), invité et spectateur (lecture et chat, sans édition).
3. Dans une salle : chat, tâches, aide
- Discussion en direct : chat persistant de la salle, visible par tous les membres et spectateurs. Un bouton micro permet d'envoyer un message vocal enregistré depuis votre navigateur ; aucune transcription automatique n'est proposée (pas de service de reconnaissance vocale disponible sur cette instance).
- Tableau des tâches : kanban simple (à faire / en cours / terminé) pour répartir le travail.
- Demander de l'aide : publiez un extrait de code bloquant avec sa stack ; les autres développeurs de la plateforme peuvent répondre, même hors de votre salle.
- Workspace : environnement d'exécution associé à la salle (statut démarré/arrêté). Son déploiement réel nécessite une infrastructure Kubernetes dédiée en production.
4. Connecter un dépôt Git
Depuis une salle, liez un dépôt en collant son URL GitHub (https://github.com/owner/repo) — aucun
compte ni jeton n'est nécessaire pour simplement le lier et consulter ses informations publiques.
- Commit direct : pour pousser un changement sans quitter Palabre, fournissez votre propre jeton d'accès personnel GitHub au moment du commit. Il n'est jamais enregistré côté serveur — il ne sert qu'à cette seule requête.
- Branches : la liste des branches montre qui a poussé quoi, depuis sa propre machine ou son propre workspace.
- Comparaison ("assemblage") : comparez deux branches pour voir ce que chaque collaborateur a produit avant de les fusionner — utile quand plusieurs personnes travaillent chacune sur sa machine distante.
- Vérifications CI : les résultats des vérifications automatiques configurées sur GitHub (tests, lint…) sont visibles directement depuis la salle.
5. Collaboration avancée
Chaque salle a un bloc "Collaboration avancée" avec cinq onglets :
- RFC & décisions : proposez un choix technique, laissez l'équipe voter (pour/contre/abstention), puis clôturez avec un résultat qui reste consultable comme trace de la décision.
- Wiki : pages markdown propres à la salle (architecture, conventions, journal de décisions…).
- Secrets : partagez un mot de passe ou un jeton chiffré (AES-256-GCM) entre membres, sans jamais l'écrire en clair dans le chat. Réservé aux hôtes/co-hôtes ; chaque consultation est journalisée.
- Fichiers partagés : éditeur de texte simplifié avec verrou doux par fichier (évite que deux personnes écrasent le travail l'une de l'autre). Dernière écriture gagne, sans fusion automatique — ce n'est pas un éditeur temps réel façon Monaco/Yjs, qui demanderait un serveur dédié non disponible ici.
- Revue de code : commentez un commit réel du dépôt lié (par son SHA), fichier et ligne en option, puis marquez le commentaire comme résolu.
6. Développeurs, Questions/Réponses, Communautés
L'annuaire des développeurs permet de chercher des profils par pays, stack, niveau ou disponibilité. Les Questions/Réponses fonctionnent comme une foire aux questions technique ouverte à toute la plateforme. Les Communautés regroupent des développeurs autour d'un centre d'intérêt (langage, framework, pays...). Le Classement affiche les développeurs les plus actifs par réputation réelle, filtrable par pays.
7. Mentorat et missions rémunérées
Depuis Mentorat, déclarez-vous mentor (spécialité, tarif en FCFA ou bénévole), publiez des créneaux, et les autres membres peuvent réserver une session. Depuis Missions, publiez une mission rémunérée, recevez des candidatures, acceptez un développeur, financez la mission puis validez la livraison pour créditer son portefeuille. Le financement est actuellement simulé : aucune passerelle de paiement réelle (iPay/Mobile Money) n'est configurée sur cette instance de démonstration.
8. Bibliothèque de snippets
La page Snippets regroupe des extraits de code réutilisables partagés par la communauté, filtrables par stack, avec copie en un clic.
9. Messages privés et notifications
Messages permet une discussion privée en dehors de toute salle (par ex. pour organiser une collaboration avant de créer une salle dédiée). Notifications, Favoris et Historique complètent le suivi de votre activité.
10. Collaborer avec un assistant IA
Palabre expose un serveur MCP (Model Context Protocol) permettant à votre assistant IA préféré d'agir en votre nom avec votre propre jeton de connexion — jamais un compte partagé. Quand un message de salle a été envoyé par un agent IA pour votre compte, il est étiqueté "via IA" : la transparence est systématique, jamais un message IA ne se fait passer pour un message humain ordinaire.
11. Mode hors-ligne
Palabre est une PWA (Progressive Web App) : vous pouvez l'installer sur votre appareil, et les pages déjà visitées restent consultables même avec une connexion instable, ce qui compte sur les réseaux mobiles africains à bande passante limitée.