Forge Clermont Université

h1. Questions Fréquentes - FAQ

{{>toc}}

h2. Généralités

h3. Qu'est-ce qu'une forge ?

Une forge est un outil de développement collaboratif de logiciels informatiques. Une forge permet d'intégrer au sein d'un projet une gestion du code source, la gestion des bugs, la documentation et la distribution des _releases_.

Forge Clermont Université est la forge du "PRES Clermont-Université":http://www.clermont-universite.fr, gérée par le centre de ressources informatiques du PRES. L'outil utilisé est un logiciel libre : "Redmine":http://www.redmine.org.

h3. Qui peut se connecter à Forge Clermont Université ?

La forge est ouverte à tous. Les membres des universités doivent utiliser le service d'authentification de leur établissement. Leur compte sera activé automatiquement à la première connexion. Les autres utilisateurs doivent demander la création d'un compte invité.

L'URL de Forge Clermont Université est : http://forge.clermont-universite.fr/.

h3. Les données sont elles sauvegardées ?

Oui. L'ensemble des données (codes sources, wiki, fichiers, documents...) est sauvegardé sur bande régulièrement.

h3. Comment contacter les administrateurs ?

Soit en ouvrant une demande de type "support":http://forge.clermont-universite.fr/projects/redmine-clruniv/issues/new?tracker_id=3 (il faut être connecté), soit directement par courriel (cf. utilisateur "admin":http://forge.clermont-universite.fr/account/show/1). Vous pouvez les contacter pour toute question technique.

h3. Où se trouve la documentation officielle de Redmine ?

Documentation de Redmine : http://www.redmine.org/guide

h2. Gestion de version

h3. Comment utilise-t-on Subversion ?

Le site officiel de Subversion est : "Apache Subversion":http://subversion.apache.org/.

Vous pouvez utiliser soit :

* le client Subversion en ligne de commande (cf. "QuickStart":http://svnbook.red-bean.com/nightly/fr/svn.intro.quickstart.html, ou le "svnbook":http://svnbook.red-bean.com/nightly/fr/svn-book.pdf), 

* soit des outils graphiques (comme "TortoiseSVN":http://tortoisesvn.tigris.org/ sous Windows), 

* soit les outils intégrés aux environnements de développement; pour l'environnement "Eclipse":http://www.eclipse.org/, il existe deux plugins : "Subclipse":http://subclipse.tigris.org/ et "Subversive":http://www.eclipse.org/subversive/.

h3. Puis-je importer un dump subversion dans la forge ?

Oui. Toutefois, l'import n'est pas automatisé. Il faut donc contacter un "administrateur":http://forge.clermont-universite.fr/account/show/1 pour effectuer l'import sur le serveur.

h3. Comment lier une révision à une demande

Il suffit que le numéro de la demande précédé du caractère # (par exemple #1) apparaisse dans le commentaire du commit. La forge établira alors le lien entre la révision et la demande. Notamment, la révision va apparaître comme 'révision associée' au niveau de la demande.

A l'inverse, vous pouvez faire référence à une révision (depuis une demande, un commentaire ou une page wiki) en spécifiant le numéro de la révision précédé d'un 'r': r1, r19. 

h3. Peut-on utiliser un autre outil de gestion de version ?

Forge Clermont Université ne propose aujourd'hui que Subversion pour gérer les codes sources. Un dépôt Subversion est créé automatiquement pour chaque projet. Toutefois, comme Redmine supporte différents "SCM":http://fr.wikipedia.org/wiki/Gestion_de_configuration_logicielle (_Source Code Management_), vous pouvez contacter l'administrateur pour utiliser un autre SCM ("Git":http://git-scm.com/, "Bazaar":http://bazaar-vcs.org/, "Mercurial":http://www.selenic.com/mercurial/).

h2. Administration d'un projet

h3. Comment créer un nouveau projet

Il y a deux conditions pour pouvoir créer un nouveau projet : 

# être authentifié sur la Forge par le "_Single Sign On_":http://fr.wikipedia.org/wiki/Sso de son établissement

# être identifié comme personnel dans l'annuaire du personnel

Si ces deux conditions sont remplies, un item "Nouveau projet" apparait sur la page "projets":http://forge.clermont-universite.fr/projects. A la création d'un nouveau projet, un dépôt Subversion sera créé automatiquement au bout d'une heure.

h3. Quelle est la différence entre un projet public et un projet privé ?

Un projet privé n'est visible que par les membres du projet, alors qu'un projet public est visible par tous, même par un utilisateur non identifié. Toutefois un visiteur anonyme ne peut participer à un projet public, il doit avoir un compte pour pouvoir soumettre des rapports de bugs ou participer aux forums de discussions. 

h3. Un manager peut-il supprimer un projet ?

Seul un administrateur peut supprimer un projet : [[Documentation#Comment-contacter-les-administrateurs-|contacter les administrateurs]].

h3. Quelles sont les permissions associées aux différents rôles (Manager, Developer, Reporter) ?

Voici la synthèse des permissions : attachment:roles-20110124.png

h2. Wiki

h3. Comment créer une nouvelle page wiki ?

Pour créer une nouvelle page dans le wiki d'un projet, il suffit de créer dans une page du wiki (la première par exemple) une référence vers la nouvelle page : ![[newpage]]. Une fois la modification enregistrée, il faut ensuite cliquer sur le lien créé pour éditer la nouvelle page (qui s'appellera dans l'exemple _newpage_). Un lien vers une page wiki inexistante apparaitra en rouge.

h3. Quel est la syntaxe du wiki ?

Redmine utilise la syntaxe Textile pour ses pages de wiki. Référence de la syntaxe Textile : http://redcloth.org/hobix.com/textile/