Amélioration de l'onboarding FLOSS

[jonathanfallon]

Notes

Contexte

• Transition de répertoires vers du micro-service.
• Réécriture en Typescript.
• Facilité les tests sur chaque brique.
• Lire https://etalab.github.io/algorithmes-publics/

Pour la publication des algos de détection de fraude :

• Montrer que les algos résolvent un problème générique.
• Expliquer leur fonctionnement général

Voir pour des templates sur les issues

Le .md "frontmatter", exemple

---
name: Nom du template
about: ...
title: ''
labels: ''
assignees: ''
---

<!-- N'apparaît pas dans le template -->
Mettez l'info ici :

Changelog

=> CHANGELOG.md

• https://keepachangelog.com/fr/1.0.0/
• Voir si besoin d'ajouter une section [Breaking changes]
• #random : https://www.youtube.com/watch?v=oyLBGkS5ICk

Contributing

• Voir https://github.com/nayafia/contributing-template

• Enjeu : rentrer facilement dans le projet.

• Enjeu sur la fiabilité de la preuve et sur l'algo : expliquer
  clairement les enjeux et comment tester.

• Qui peut contribuer ? Sur quoi ?

• Expliquer l'usage du Semantic versioning.

• Summary in French

• Summary in English

Principles

• 12 factor app
• Consumer driven-contracts
• OpenAPI 3 documentation
• Correlation IDs to track calls across services

Resources

• https://docs.pact.io/

https://github.com/nayafia/contributing-template
Roads and Bridges

Envisager un code of conduct

https://opensource.guide/fr/code-of-conduct/

License (dans le Readme)

DINSIC, 2017-2019.
The source code is published under blabla (avec un lien vers la licence).

Issues

• Ajouter des templates
• possibilité de pré-assigner des tags