Nouvelle documentation développeurs

Cozy a ceci de particulier que c’est une plateforme, comme GNU/Linux, Windows ou iOS : son principal intérêt est de pouvoir faire tourner des applications. Pour favoriser la création de telles applications, il faut permettre aux développeurs indépendants d’en créer sans perdre de temps. En cela, la documentation à l’attention des développeurs est cruciale. Nous disposions déjà d’une telle documentation, mais nous avons voulu la refondre en la traitant comme une application, de lui faire suivre le même processus de développement, d’y apporter le même soin et la même rigueur; bref d’intégrer la documentation au produit et ne pas la traiter à part.

Dans un premier temps, nous avons recueilli les retours des développeurs (qu’ils aient réussi à créer une application ou pas), pour mieux comprendre quels étaient les manques et les points de blocages. Nous nous sommes aussi aperçus qu’il n’existait pas une “application Cozy”, mais plusieurs façon de créer un service et d’interagir avec les données :

  • une application Node.js
  • un connecteur
  • une application externe (par exemple l’application mobile)

Nous souhaitons développer une documentation pour chaque type d’application, mais nous devions commencer par les applications les plus courantes, la nouvelle documentation se concentre donc sur les application Node.js pour Cozy. Son but est d’expliquer comment réaliser une application Node.js simple (une API HTTP) et de présenter en détails les interactions avec les données.

Retrouvez dès à présent (en anglais) :

Comme d’habitude chez Cozy, toute la documentation est disponible sur un dépôt Github où chacun (oui, vous aussi !) peut contribuer.

Par ailleurs, nous sommes conscients chez Cozy que commencer à développer une application dans un nouvel environnement est souvent impressionnant. C’est pourquoi nous avons mis en place un programme de mentorat.

Maintenant, c’est à vous de jouer : et si vous commenciez par écrire votre première application Cozy, que vous pourrez faire tourner sur votre Cloud personnel (et celui des autres !) ?