Note : les pages Scol sur SourceForge sont inusités. Cependant, elles pourront être réactivées un jour d'où la persistence de cette FAQ.

 

• Pourquoi SourceForge ? 

Les serveurs de SourceForge hébergent des projets openSource c'est-à-dire des projets ouverts où chacun peut participer suivant ses compétences. Ces serveurs intègrent des outils spécialisés pour la gestion et l'utilisation de ce type de projet.
Scol étant une technologie openSource, elle est naturellement présente sur SourceForge.

Les pages Scol sur SourceForge sont en train d'être mises à jour progressivement ... ;-)
Vous pouvez déjà rapporter les bugs que vous observez et aider ainsi plus rapidement à diffuser une version de Scol stable !

 

• Pour qui ? 

Tout le monde :-) Des simples utilisateurs qui voudront se tenir au courant des derniers développements ou qui voudront mentionner un bug ou une demande, aux programmeurs les plus acharnés qui trouveront tous les documents nécessaires à leur travail.

 

• Comment y accéder ? 

En suivant ce lien http://sourceforge.net/projects/scol

 

• Comment participer : pour les développeurs ? 

Pour participer activement, mieux vaut contacter les administrateurs du projet Scol en expliquant vos motivations.

 

• Comment participer : pour consulter, recueillir des informations, signaler un bug ? 

Rendez-vous sur http://sourceforge.net/projects/scol

Une page s'affichera avec cette barre de liens :

Summary	C'est sur cette page qu'on arrive en se connectant. Elle présente un récapitulatif du contenu du site.
Admin	Cette page permet d'accéder à la zone d'administration. Vous ne devriez pas y avoir accès ! ;-)
Home Page	C'est la page de présentation de Scol sur SourceForge.
Tracker	Cette page résume l'activité relative aux reports/corrections de bugs et aux diverses demandes (et réponses appropriées !) formulées par les utilisateurs. Voir les rubriques "bugs", "support", "patches" et "RFE" ci-dessous.
Bugs	Cette page liste les bugs répertoriés par les utilisateurs avec leurs réponses éventuelles. Si vous connaissez un problème avec Scol, visitez cette page, peut-être trouverez-vous la solution :-) Sinon n'hésitez pas à nous en faire part ou à partager vos solutions ;-) !
Support	Cette page assure, comme son nom l'indique, le support (la liaison en quelque sorte) entre les utilisateurs et la technologie Scol.
Patches	{ support et patches se regroupent quand on simplifie comment les définir au mieux ?}
RFE	Cette page recense les demandes d'évolution formulées par l'ensemble des utilisateurs.
Lists	Vous trouverez sur cette page l'ensemble des mailings listes disponibles sur Scol (une mailing list est une discussion par mail) : scol-talk = pour des conversations d'ordre générale scol-info = pour connaître les principales infos sur l'évolution de Scol (cette liste est modérée a priori sinon accessible qu'en lecture seule). scol-tech = pour des questions/réponses techniques : conception, création de sites, modélisation 3d, ... scol-devel = pour des discussions très techniques sur la programmation en Scol Si vous désirez vous inscrire à une ou plusieurs de ces listes suivez le guide ci-dessous "Coment s'inscrire" !
CVS	Le CVS permet de gérer le développement technique entre plusieurs développeurs. A priori si vous n'êtes pas développeur aucune info ne vous sera utile.
Files	Cette page liste l'ensemble des fichiers disponibles pour une utilisation directe de Scol (Scol Voy@ager et distribution SCS/Modules).

 

•  Comment remplir le Tracker utilement ? 

Le tracker permet d'avoir accès aux pages :
- bugs,
- support,
- patches,
- features request (demandes d'une nouvelle fonctionalité, etc ...).

La méthode de composition étant identique pour ces 4 domaines, nous prendrons exemple sur la page "bugs".
Supposons donc que vous avez déniché un bug qui n'est pas déjà inscrit.
La première chose à faire est de vous identifier afin de pouvoir éventuellement rentrer en contact pour vous répondre ou vous demander des informations supplémentaires.
Pour vous identifier : https://sourceforge.net/account/login.php.
Entrez votre nom d'utilisateur et le mot de passe que vous avez choisi. Vous pouvez laisser les autres options telles quelles.

Si vous ne vous êtes jamais inscrit sur SourceForge, créez-vous un compte (c'est totalement gratuit et sans pub !) : https://sourceforge.net/account/register.php

Une fois inscrit rendez-vous sur la page 'bugs' (ou support ou patches ou RFE suivant le cas).
Vous arrivez sur une page "Project: scol: Browse Bugs". La liste des bugs déjà répertoriés permet de vérifier que le votre n'est pas déjà référencé ou qu'une correction n'est pas proposée.
Cette vérification étant faite, cliquez sur "Submit New" (Soumettre une nouvelle entrée).

Renseignez les champs suivants qui permettront de mieux orienter votre requête aux personnes concernées :

- Group (Groupe)	Choisissez le groupe qui, à votre avis, convient le mieux à votre demande : - 3D - Pour toute la modélisation (création de la 3d) ou bugs d'exportation de la 3D dans Scol. - Miscellaneous - Si vous ne trouvez pas de groupe approprié ou si vous ne savez pas quel groupe choisir. - Modules - Pour les bugs des modules DMS. - SCOL Server - Pour les bugs du serveur Scol (GNU/Linux ou Windows). - SCOL Voy@ger - Pour les bugs du plugin (le logiciel que vous utilisez pour vous connecter à un site Scol). - SCS - Pour les bugs du SCS, le logiciel de création de site.
- Category (Catégorie)	Choisissez ensuite la catégorie qui, à votre avis, convient le mieux à votre demande : - 3D - pour les problèmes lié à la 3D. - Install - pour les problèmes avec un installer (un fichier qui 'installe' un logiciel Scol sur votre ordinateur). - Kernel - pour les problèmes avec les fichiers exécutables. - Miscellaneous - si aucune autre catégorie n'est appropriée ou que vous ne savez pas quelle catégorie choisir. - SCOL Language - pour les problèmes avec le langage de programmation SCOL. - Web - pour les problèmes lié à l'utilisation de Scol avec le Web classique (en 2D).
- Summary (Résumé)	Donnez un titre résumant bien votre question ou le bug que vous avez rencontré.
- Detailed Description (Description détaillée)	Ces informations sont probablement les informations les plus importantes que vous devez fournir. Donnez une description courte mais claire de votre problème, donnez ensuite autant d'informations que possible en évitant les phrases du type 'ça ne marche pas', 'le truc se connecte pas à mon site' ... qui n'apportent aucune compréhension du problème rencontré. Par exemple : - Votre environnement matériel : type et puissance de votre processeur, quantité de mémoire et de mémoire vidéo disponibles, modèle de carte graphique et version des pilotes installés, etc ... - Votre environnement logiciel : système d'exploitation (windows 98 windows XP Linux ...), version du Scol Voy@ger ou du SCS installée, OpenGL installé ou non, tout programme résident en mémoire (notamment antivirus, optimiseurs de performances, ...), etc ... - Votre description de ce qui s'est passé. Par exemple "j'ai cliqué sur le bouton "Blabla" et la fenêtre permettant de configurer ma webcam ne s'est pas ouverte". Soyez précis et listez ce que vous avez fait afin de pouvoir reproduire ce problème et le résoudre ! S'il s'agit d'un problème avec le SCS ou avec un module DMS, n'oubliez pas d'indiquer les liens concernés et les éventuels paramètres, le mieux étant de refaire un petit site avec le module incriminé, les librairies standards et joindre ainsi le fichier .dms. Enfin, si vous pensez que cela peut s'avérer utile, joignez une capture d'écran, un bout de code, un fichier qui pourrait apporter des informations supplémentaires. Pour cela, en bas de page, cochez la case "Check to Upload and Attach a File", cliquez sur "Browse" (Parcourir) pour sélectionner le fichier joint à envoyer, expliquez briévement ce dont il s'agit dans le champ "File Description" (description du fichier). Une fois terminé et relu, appuyez sur "Submit" pour envoyer votre contribution. :). Notez que pour déposer une requête, une demande de nouvelles fonctionnalité, c'est exactement les mêmes champs qu'il faut remplir. Notez également que vous n'êtes pas obligés d'écrire en anglais (c'est tout de même plus efficace pour être compris de tous !).

Il est inutile de modifier les champs ASSIGNEE et STATUS

 

• Comment s'inscrire ? 

Cliquez sur ce lien http://sourceforge.net/account/register.php.

La page se nomme "Register a New User Account" (Enregistrement d'un nouveau compte).
Quelques renseignements nécessaires à votre inscription (totalement gratuite) vous sont demandés.
Login Name (do not use uppercase letters) = Nom d'utilisateur (ne pas utiliser de majuscules)
Entrez donc un nom ... Par ex "toto"

Password (min. 6 chars) = Mot de passe (au minimum de 6 caractères)
Il s'agit du mot de passe qui sera associé au nom d'utilisateur ci-dessus. Par ex "abc123".
NE PAS UTILISER de caractères autres que des lettres ou des chiffres

Password (repeat) = Mot de passe (réincrivez-le)
Le retaper permet d'éviter les erreurs. Donc 'abc123'

Publicly Displayed Name = Nom public qui sera affiché (il peut donc être différent du "nom d'utilisateur").
Nos contributions seront affichées sous ce nom (report de bugs, etc ...). Par ex "Bill Gates"

Language Choice = Langue utilisée. Sélectionnez "French" pour Français.
(Ca ne changera pas grand chose pour l'instant le système de localisation n'étant pas encore actif, les pages resteront en anglais)

Timezone = Le décalage horaire par rapport à l'heure de Greenwich.
Choisissez dans le menu déroulant "Europe/Paris" pour les personnes domiciliées en France ;).

Email Address = Courriel.
Saisissez une adresse mail valide ! Par ex : "toto@toto.com"
Cette adresse ne sera pas publique (personne ne la verra) et servira à activer notre compte et à récupérer notre mot de passe en cas de perte.

Ensuite, vous pouvez cocher deux cases si vous souhaitez
1- recevoir par email des infos sur les mises à jour du site,
2- recevoir des mailings supplémentaires ..... Aucune publicité commerciale ne vous sera envoyés par ce moyen.

Cliquez sur le bouton Register et attendez un court instant ...

La même page s'ouvre. Vous êtes priés de vérifier les renseignements que vous avez entrés. Si tout est correct, validez ! (bouton en bas de page).

Une dernière page s'ouvre vous informant qu'un email vous a été envoyé. Pour confirmer et valider définitivement votre inscription, vous devrez cliquer sur le lien contenu dans ce mail.

 

 

• Quelles sont les mailing-lists ? Comment m'inscrire ? 

Les listes sont disponibles à cette adresse : http://sourceforge.net/mail/?group_id=76682

- Vous en trouverez quatre chacune couvrant un domaine particulier :

Scol-info

Sur cette liste sont diffusées régulièrement les informations d'ordre général sur la technologie Scol. Utile pour se tenir informer des principaux développements.

Scol-talk

Cette liste permet les échanges généraux sur Scol (mise en place d'un nouveau ScolProject, d'un nouveau site, d'idées et de commentaires divers).

Scol-tech

Cette liste est un lieu d'échange pour les concepteurs de site et les utilisateurs avancés (ou désirant s'initier) à la technologie Scol.

Scol-devel

Cette liste est privilégiée par les développeurs qui s'échangent questions et informations sur le langage Scol.

- Inscription à une ou plusieurs listes :

Cliquez sur le lien "Subscribe/Unsubscribe/Preferences" situé sous la définition de chacune des listes dont vous souhaitez devenir membre (vous pourrez alors envoyer des messages). Une page s'ouvrira : en haut le titre de la liste. Dans la section "Subscribing to Scol-devel", saisissez une adresse email valide puis choisissez un mot de passe "Pick a password" (pas celui de votre email évidemment) et retapez-le pour éviter les erreurs de frappe "Reenter password to confirm". Si vous désirez recevoir un mail récapitulatif journalier plutôt que chaque message à un à un, cochez "Yes". Cliquez sur Subscribe.

 

• Puis-je lire les discussions sur les mailing-lists sans être inscrit ? 

Oui, vous pouvez lire les messages envoyés mais vous ne pourrez ni répondre ni lancer un nouveau sujet.

Rendez-vous à l'onglet | Lists | sur SourceForge.
Cliquez sur les archives de la ML qui vous intéresse. Les messages sont classés chronologiquement et un tableau mensuel récapitule leur nombre.

 

• Comment participer : pour déposer une demande ou rapporter un bug ? 

Pour cela vous devez au préalable vous inscrire sur SourceForge. Si vous n'êtes pas familier avec l'anglais, un pas à pas est disponible.

Pour savoir où et comment déposer votre demande ou signaler un bug (ou un problème) , voyez plus haut.

Attention : s'il s'agit d'un problème spécifique à un site, contactez directement la (ou les) personne(s) l'administrant. Une telle requête sur SourceForge sera immanquablement rejetée.