À-propos de ce site

Buts

OCaml.org est un site internet géré de manière communautaire, créé par et pour les développeurs OCaml, ainsi que ceux qui s'intéressent à ce langage de programmation. Les buts de ce site sont :

être la vitrine publique du langage OCaml ;
servir de ressource aux utilisateurs d'OCaml ;
devenir l'endroit privilégié pour que ces utilisateurs puissent indiquer aux autres où s'informer et découvrir les nouveautés ;
donner aux visiteurs occasionnels, aux nouveaux utilisateurs, ainsi qu'à la communauté des programmeurs tout ce qui peut leur être utile au sujet d'OCaml.

Les raisons de ce qui précède sont les suivantes. Les utilisateurs doivent trouver une utilité à ce site web ou bien il y aura peu de chances qu'ils le visitent et y contribuent. Quand ces utilisateurs trouvent quelque chose d'intéressant sur le site web, ils seront plus enclins à transmettre ce lien à d'autres personnes.

Administrateurs du site web

Une petite équipe de volontaires font don de leur temps pour gérer et développer ce site internet. Ces personnes veillent à la bonne marche du site et s'assurent que les buts pré-cités soient respectés, tout en conservant une cohérence uniforme de l'ensemble du site pour tous les visiteurs. Leur responsabilité est notamment d'administrer à la fois le contenu, sa présentation, son ergonomie, mais aussi l'infrastructure sous-jacente et les outils nécessaires à sa gestion collaborative. Actuellement le coeur de l'équipe assurant la gestion du site 'www.ocaml.org' est constituée de :

La décision d'ajouter ou d'enlever des personnes de cette liste se fait par concensus, et l'appartenance est basée essentiellement sur les contributions au site ou à son infrastructure. Comme le site et sa communauté grandiront il est possible qu'elle requière une gouvernance plus formelle, et tout changement ou discussion par rapport à ça pourront prendre place sur la liste de discussion infrastructure, avec des notifications appropriées sur la liste de discussion principale d'OCaml.

Gestion du domaine ocaml.org

La façade publique du site web n'est qu'un des projets associé au nom de domaine ocaml.org. Le nom de domaine a son propre document de gouvernance, auquel vous devez vous référer pour savoir comment sont gérés les sous-domaines.

Comment Contribuer

Le site ocaml.org est actuellement géré à l'aide de GitHub ainsi que de la liste de discussion infrastructure. Pour proposer du contenu ou des améliorations, veuillez forker le projet puis utiliser la fonctionnalité "requête de fusion" fournie par GitHub ("pull request" en anglais). Celle-ci sera alors examinée par l'un des membres de l'équipe d'ocaml.org pour inclusion. Notre réactivité est généralement de quelques minutes.

Directives d'Édition

Veuillez créer une duplication du dépôt (fork) et utilisez le système de « requête de fusion » (pull request) pour envoyer des changements. Pour ajouter ou modifier du contenu vous pouvez aussi cliquer sur le petit crayon dans le coin en haut à droite, ce qui va créer la page correspondante dans votre espace GitHub. À cet endroit vous pourrez éditer des pages, puis réaliser une requête de fusion (pull request).
N'ajoutez pas de gros fichier, vous devez les mettre autre part et mettre un lien vers ceux-ci. Il est possible d'héberger quelques fichiers dans le dépôt séparé : ocaml.org-media.
Veuillez noter que les demandes de fusion (pull requests) ont la priorité sur les points à débattre (issues).
Prenez connaissance du fait que le contenu envoyé sera placé sous la licence indiquée dans le fichier LICENSE.
Si vous envoyez des changements importants, veuillez les tester localement avant avec la commande make.
Si vous n'êtes pas sûr de comment vous y prendre, vous pouvez toujours nous aider en ouvrant un point à débattre (issue).
Enfin veuillez vous rappeler que le site est géré bénévolement!

La liste des contributeurs est automatiquement générée à partir des logs de Git, aussi assurez-vous de faire vos commit avec votre véritable nom et prénom dans Git (set up your identity).

Résolution de Conflit

Dans la plupart des cas, le contenu et les corrections peuvent être fusionnés simplement. Dans les rares cas où il y aurait des désaccords, nous procéderont de la manière suivante :

Le point à débattre devra présenter clairement ce qui a besoin d'être discuté.
Les autres membres de l'équipe d'ocaml.org seront priées de rejoindre la discussion sur la page de la requête de fusion.
Si la discussion ne peut pas être résolue rapidement, la requête de fusion devra être fermée et la discussion pourra continuer sur la liste de discussion infrastructure, où d'autres membres pourront présenter leur point de vue.

En général nous préférons parvenir à un consensus au sein de la communauté pour résoudre les mésentantes.

Logos

Des logos d'OCaml sont mis à votre disposition et vous êtes encouragé à les réutiliser dans vos projets et sur vos sites internet pour promouvoir OCaml et apporter votre support à sa communauté.