Contribuer

La pile est celle de MinOS et de Kolekti : Vue 3, Vite, TypeScript, Vuetify, Vitest, Hono, VitePress, yarn 4, ESLint, Prettier.

Lancer le projet

yarn install

Dans trois terminaux :

yarn dev:server

yarn dev

yarn docs:dev

La page est sur http://localhost:5173, et la documentation sur http://localhost:5174. Le relais parle au vrai Nextcloud par défaut : pour faire des essais, faites-le pointer ailleurs avec CORICO_NEXTCLOUD.

La vidéo de démonstration

yarn video la refilme, sur un écran virtuel, avec un faux Nextcloud et un faux micro (demos/video/README.md) ; yarn video:publish l'envoie sur le site de la documentation.

Vérifier avant de proposer

yarn lint

yarn typecheck

yarn test

yarn docs:build

Les règles du projet

• Le relais ne garde rien. Aucun stockage, aucun journal de requêtes, aucun service tiers. Tout changement de ce qui est vu, gardé ou envoyé met à jour la page de confidentialité dans le même commit.
• Deux langues. L'interface et la documentation existent en anglais et en français, et chaque changement touche les deux.
• Une documentation pour tous. Le guide s'adresse à des enseignants : pas de mot technique sans explication, et tout mot nouveau rejoint le glossaire.
• L'interface d'abord. Lisez les choix d'interface avant d'y toucher.
• Commits atomiques, un sujet par commit.