funky-framadate-front/site/dev-guide/CONTRIBUTE/index.html

320 lines
15 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="canonical" href="https://framagit.org/framasoft/framadate/funky-framadate-front/dev-guide/CONTRIBUTE/">
<link rel="shortcut icon" href="../../img/favicon.ico">
<title>Contribuer - Funky Framadate Front end</title>
<link href="../../css/bootstrap.min.css" rel="stylesheet">
<link href="../../css/font-awesome.min.css" rel="stylesheet">
<link href="../../css/base.css" rel="stylesheet">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/darcula.min.css">
<script src="../../js/jquery-1.10.2.min.js" defer></script>
<script src="../../js/bootstrap.min.js" defer></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head>
<body>
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
<div class="container">
<a class="navbar-brand" href="../..">Funky Framadate Front end</a>
<!-- Expander button -->
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
<span class="navbar-toggler-icon"></span>
</button>
<!-- Expanded navigation -->
<div id="navbar-collapse" class="navbar-collapse collapse">
<!-- Main navigation -->
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Accueil <b class="caret"></b></a>
<ul class="dropdown-menu">
<li>
<a href="../../index.fr/" class="dropdown-item">Framadate - funky version</a>
</li>
<li>
<a href="../../TODO/" class="dropdown-item">en cours</a>
</li>
</ul>
</li>
<li class="dropdown">
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Guide utilisateur <b class="caret"></b></a>
<ul class="dropdown-menu">
<li>
<a href="../../user-guide/" class="dropdown-item">Guide utilisateur</a>
</li>
<li>
<a href="../../LICENCE.md" class="dropdown-item">None</a>
</li>
</ul>
</li>
<li class="dropdown">
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Guide administrateur <b class="caret"></b></a>
<ul class="dropdown-menu">
<li>
<a href="../../changelog/" class="dropdown-item">Changelog</a>
</li>
</ul>
</li>
<li class="dropdown active">
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Guide développeur <b class="caret"></b></a>
<ul class="dropdown-menu">
<li>
<a href="../../GETTING_STARTED/" class="dropdown-item">Démarrer</a>
</li>
<li>
<a href="../../customisation/" class="dropdown-item">Personnaliser</a>
</li>
<li>
<a href="../../cadrage/accessibility/" class="dropdown-item">Accessibilité</a>
</li>
<li>
<a href="../../cadrage/architecture/" class="dropdown-item">Architecture</a>
</li>
<li>
<a href="./" class="dropdown-item active">Contribuer</a>
</li>
<li>
<a href="../../angular/" class="dropdown-item">Angular</a>
</li>
<li>
<a href="../../cadrage/i18n/" class="dropdown-item">Traduction</a>
</li>
</ul>
</li>
<li class="dropdown">
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Historique <b class="caret"></b></a>
<ul class="dropdown-menu">
<li>
<a href="../../history.md" class="dropdown-item">Historique</a>
</li>
<li>
<a href="../../cadrage/specifications-fonctionnelles/" class="dropdown-item">Spécifications</a>
</li>
<li class="dropdown-submenu">
<a href="#" class="dropdown-item">Réunions</a>
<ul class="dropdown-menu">
<li>
<a href="../../reunions/0_blank_notes/" class="dropdown-item">Modèle vierge</a>
</li>
<li>
<a href="../../reunions/2020_08_09/" class="dropdown-item">20200809</a>
</li>
<li>
<a href="../../reunions/2019_08_09/" class="dropdown-item">20190809</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<ul class="nav navbar-nav ml-auto">
<li class="nav-item">
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
<i class="fa fa-search"></i> Search
</a>
</li>
<li class="nav-item">
<a rel="prev" href="../../cadrage/architecture/" class="nav-link">
<i class="fa fa-arrow-left"></i> Previous
</a>
</li>
<li class="nav-item">
<a rel="next" href="../../angular/" class="nav-link">
Next <i class="fa fa-arrow-right"></i>
</a>
</li>
</ul>
</div>
</div>
</div>
<div class="container">
<div class="row">
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
<div class="navbar-header">
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
<span class="fa fa-angle-down"></span>
</button>
</div>
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
<ul class="nav flex-column">
<li class="nav-item" data-level="1"><a href="#comment-contribuer-a-framadate-funky" class="nav-link">Comment contribuer à Framadate funky ?</a>
<ul class="nav flex-column">
</ul>
</li>
<li class="nav-item" data-level="1"><a href="#qui-veut-faire-quoi" class="nav-link">Qui veut faire quoi ?</a>
<ul class="nav flex-column">
</ul>
</li>
<li class="nav-item" data-level="1"><a href="#liens-utiles" class="nav-link">Liens utiles:</a>
<ul class="nav flex-column">
</ul>
</li>
</ul>
</div>
</div></div>
<div class="col-md-9" role="main">
<ul>
<li class="i18n-link i18n-link-not-found i18n-link-en">English: This page isn't translated to English.</li>
</ul>
<h1 id="comment-contribuer-a-framadate-funky">Comment contribuer à Framadate funky ?</h1>
<p>Il existe des tas de façons de contribuer à un logiciel libre comme Framadate. Vous pouvez <strong>discuter</strong> avec d'autres personnes de ce que vous souhaiteriez voir naître dans le logiciel, <strong>essayer</strong> de l'utiliser dans sa version expérimentale, <strong>mettre en place une démo</strong> ou un service publiquement utilisable, <strong>écrire</strong> des modifications de code, proposer de l'aide de toute sorte, <a href="../../cadrage/i18n/">traduire les textes</a>, vérifier l'accessibilité, lire la <a href="../../cadrage/architecture/">documentation d'architecture</a> etc... </p>
<ul>
<li>Avoir un compte Framateam, et Framagit si vous souhaitez contribuer au code</li>
<li>Examiner les tickets
Discuter avec les autres membres participant, sur un ticket en particulier et aussi dans les canaux de framateam</li>
<li>Nous avons créé deux canaux: un pour les discussions générales, et un autre pour les discussions techniques de dev. Prenez soin de bien cibler le canal dans lequel vous communiquez afin de ne pas faire peur aux gens qui ne codent pas et qui souhaitent contribuer de toutes les autres façons.</li>
<li>Une fois d'accord avec les autres, mettre à jour votre dépot de travail local. Voir <a href="../../GETTING_STARTED/">la doc d'installation / getting started</a> à ce sujet.</li>
<li>Utiliser la branche <code>develop</code>
<code>git checkout develop
git fetch</code></li>
<li>choisir un ticket gitlab consacré à votre branche, si il n'en existe pas, le créer. Un ticket doit avoir un sujet suffisament petit pour pouvoir le réaliser dans un temps raisonnable. Faites des sous-tickets reliés pour les longues fonctionnalités. Le but des tickets n'étant pas de rester ad vitam dans la backlog, mais bien de montrer un avancement détaillé, avec un titre évocateur. "exit donc les tickets du genre 'ça ne marche pas' ou 'finir framadate'"</li>
<li>Faire une branche dédiée à vos modifications en lui mettant un nom éloquent.
<code>git checkout -b ma-description-de-fonctionnalite</code></li>
<li>lisez les logs des commits les plus récents pour comprendre ce qui se passe.</li>
<li>Faites des petits commits, avec un titre désignant précisément ce sur quoi vous progressez.</li>
<li>Faire une merge request sur framagit qui sera soumise à la revue de code par les pairs du projet.</li>
<li>Continuer à interagir avec les autres membres pour utiliser au mieux les savoir-faire de chacun et ne pas se marcher sur les pieds. </li>
<li>Mettez toujours en avant la politesse et l'empathie, la collaboration n'en sera que meilleure.</li>
<li>N'hésitez pas à contacter en direct les personnes avec lesquelles vous souhaitez avancer.</li>
</ul>
<h1 id="qui-veut-faire-quoi">Qui veut faire quoi ?</h1>
<ul>
<li>maiwann : maquettes, UX</li>
<li>tykayn : développeur front end, JS &amp; styles</li>
<li>newick : intégrateur dans la vraie vie</li>
<li>llaq : plutôt HTML / css et un peu de développement en php</li>
<li>talone : plutôt coté JS</li>
<li>tcit : dev tout qui connait bien le backend de Framadate actuel</li>
<li>pouhiou : soutien moral</li>
<li>come_744 : git, découverte d'angular</li>
<li>arnaldo : php, découverte du libre</li>
<li>elbuffeto : l'intégration HTML/CSS, accessibilité</li>
<li>l4pin : un peu de front JS, beaucoup de back</li>
<li>wadouk : dev compilé (elm, haskell, scala)</li>
<li>cbossard : dev (plutôt backend), java/javascript, avec un peu de temps en ce moment</li>
<li>seraf : dev fullstack (plutôt front), JS (Angular, VueJS, Svelte), PHP (Symfony, ApiPlatform), Java (Spring)</li>
</ul>
<h1 id="liens-utiles">Liens utiles:</h1>
<ul>
<li>Discussion : https://framateam.org/ux-framatrucs/channels/framadate</li>
<li>Repo front/dev : https://framagit.org/framasoft/framadate/funky-framadate-front/tree/dev </li>
<li>Repo back : https://framagit.org/framasoft/framadate/framadate </li>
<li>Maquettes Zeplin : demander l'accès à maiwann</li>
<li>La démo : https://framadate-api.cipherbliss.com/</li>
<li>Vidéo de présentation au lancement de la refonte : https://nuage.maiwann.net/s/JRRHTR9D2akMAa7</li>
</ul></div>
</div>
</div>
<footer class="col-md-12">
<hr>
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
</footer>
<script>
var base_url = "../..",
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
</script>
<script src="../../js/base.js" defer></script>
<script src="../../search/main.js" defer></script>
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
<div class="modal-dialog modal-lg">
<div class="modal-content">
<div class="modal-header">
<h4 class="modal-title" id="searchModalLabel">Search</h4>
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
</div>
<div class="modal-body">
<p>
From here you can search these documents. Enter
your search terms below.
</p>
<form>
<div class="form-group">
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
</div>
</form>
<div id="mkdocs-search-results"></div>
</div>
<div class="modal-footer">
</div>
</div>
</div>
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
</div>
<div class="modal-body">
<table class="table">
<thead>
<tr>
<th style="width: 20%;">Keys</th>
<th>Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="help shortcut"><kbd>?</kbd></td>
<td>Open this help</td>
</tr>
<tr>
<td class="next shortcut"><kbd>n</kbd></td>
<td>Next page</td>
</tr>
<tr>
<td class="prev shortcut"><kbd>p</kbd></td>
<td>Previous page</td>
</tr>
<tr>
<td class="search shortcut"><kbd>s</kbd></td>
<td>Search</td>
</tr>
</tbody>
</table>
</div>
<div class="modal-footer">
</div>
</div>
</div>
</div>
</body>
</html>