-
Notifications
You must be signed in to change notification settings - Fork 7
/
contribute.html
75 lines (71 loc) · 3.21 KB
/
contribute.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
<!doctype html>
<html>
<head>
<title>Ateliers : exercices de programmation</title>
<meta charset="utf-8">
<link href="style.css" rel="stylesheet" type="text/css">
</head>
<body class="page-layout">
<div class="header">
<a href="index.html">Liste des ateliers</a>
<a href="../blog/index.html">Blog</a>
<a href="contribute.html">Contribuer</a>
</div>
<div id="container">
<a class="std-button" href="index.html">Revenir à la page d'accueil</a>
<h1>Comment contribuer</h1>
<h2>Guide général de contribution</h2>
Cette page étant un véritable temple de modernité, il s'agit d'une
<a href="https://github.com/atelier-prog/atelier-prog.github.io">page
hébergée sur Github</a>. Il suffit donc de soumettre un patch pour créer
une modification. Il n'y a aucun générateur.
La contribution peut prendre deux formes:
<ol>
<li>Ajouter un exercice</li>
<li>Ajouter une solution</li>
</ol>
<p>
Attention, dès lors qu'une contribution est validée, elle est
considérée comme libre (sauf si une note <strong>explicite</strong>,
altère la licence du contenu).
</p>
<h4>Ajouter un exercice</h4>
<p>
L'ajout d'un exercice s'effectue en deux étapes. La première consiste
à lui créer une page, en se servant <a href="topics/template.html">
du template</a> et de l'enregistrer dans le répertoire
<code>topics</code>, ensuite il suffit de modifier la liste pour ajouter
votre exercice dans la liste (en tâchant de l'ordonner correctement
pour préserver une certaine logique dans la suite d'exercices).<br />
Il est conseillé de fournir une première solution pour évincer les
potentielles premières ambiguïtés, donc il n'est pas nécéssaire
de proposer une solution absolument overkill et l'usage d'un langage
<i>mainstream</i> est conseillé. <br />
Essayez de rédiger des exercices claires idéalement dans un HTML5
valide.
</p>
<h4>Ajouter une solution</h4>
<p>
L'ajout d'une solution pour un exercice consiste simplement à
modifier la page de l'exercice pour ajouter sa propre solution. En
s'inspirant de celle des autres. Une solution est représentée par
un lien vers une page de votre choix (un répertoire Git par exemple)
avec, idéalement, une explication de comment lancer votre solution et
peut être un bilan de l'implémentation.<br />
Bien que le courriel soit facultatif, il est tout de même conseillé
de le mettre, pour permettre aux éventuels lecteurs d'effectuer un
retour sur votre proposition.
</p>
<p>
Les contributions sont statiques, on compte donc sur la maturité de
chacun pour ne pas saccager le travail des autres.
</p>
<h4>Commenter</h4>
<p>
Chaque page d'exercice propose un espace de conversation (fourni par
disqus.com). Une forme naïve de contribution est de poser des questions
ou de répondre à ces questions dans les espaces proposés à cet effet !
</p>
</div>
</body>
</html>