Publier un matériel open source

De Wiki FOSM

Pour publier un matériel open source, il faut mettre à disposition les éléments suivants :

  • sa liste de composants
  • ses plans et schémas de conception
  • son manuel d’assemblage
  • son manuel d’utilisation


La publication sur la plateforme Fédération se divise en deux parties :

  • une page statique du portail Fédération, qui fait office de présentation du matériel, de manuel d’assemblage et de manuel d’utilisation. S’y trouve aussi la liste exhaustive des composants.
  • un dépôt gitlab public, qui contient les fichiers sources pour les pièces à imprimer

La répartition des différents éléments entre les deux supports n'est pas figée : l'essentiel est bien que tous les 4 éléments constitutifs d'un matériel open source soient bien disponibles.


En complément des schémas de conception et autres plans, deux autres éléments importants doivent être inclus dans le dépôt git :

  • le fichier licence qui indique que la licence sous laquelle est placée le matériel
  • le fichier authors qui relate l’historique du projet et ses principaux contributeurs. Oui, open source ne signifie pas pour autant que les contributeurs restent anonymes !

Création de la page statique

Dans "l'espace projet" de votre projet, sur le portail, l'équipe crée une page dédiée à la publication. Elle récapitule le maximum d'éléments du projet, et donne les clés pour retrouver l'ensemble des quatre composantes d'un matériel open source. Sur cette page se trouve notamment le lien vers le dépôt gitlab public, mais c'est aussi l'endroit pour faire un peu de "marketing" sur le matériel, en mettant en avant des photos, vidéos ou autres illustrations.

Une fois la page statique créée dans l'espace projet, manifestez-vous sur le forum pour qu'elle soit ensuite copiée par un administrateur dans l'espace "Publications" du portail Fédération.

Création du dépôt Gitlab public

Un référent d'un projet (ou d'un groupe thématique) peut demander d'activer l'espace de publication des sources sur le Gitlab.

Il faut au préalable que l'outil GitLab - Forge Logicielle ait été activé pour ce projet.

Pour activer cet espace, il faut cocher la case dans l'interface de modification du projet (groupe thématique). Le sous groupe sera créé et disponible quelques minutes après.

Activer l'espace de publication

Un sous groupe est alors créé sur l'instance Gitlab dans les groupes publics suivants :

Les référents du projet (groupe/thématique) ont alors les droits de créer un ou plusieurs projets avec dépôt Gitlab dans le sous groupe public du projet (groupe thématique), et la possibilité de publier les sources dans chaque dépôt.

L'URL du dépôt doit être dans le sous groupes publics (p-releases/... ou tg-releases/...)

Le projet Gitlab doit être "public".

Création d'un nouveau projet public