Aide aux nouveaux arrivants sur Developpez.com

Higgins

Cet article proposé par Higgins est là pour aider les nouveaux à profiter pleinement des possibilités de Developpez.com. Lisez-le attentivement avant de poster une question, les conseils présentés ici vous seront précieux pour vous intégrer au Club.

Si vous avez besoin d'assistance, un forum est dédié à l'assistance aux nouveaux.

- Titre : Aide aux nouveaux arrivants sur Developpez.com

- Auteur : Higgins

- Parution : 7 janvier 2005

- Mise à jour : 5 novembre 2017

- Licence : Copyright ® 2005 Higgins. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Aide aux nouveaux arrivants sur Developpez.com

- I-A. Identifier le problème

- I-B. Chercher un petit peu

- II. Utiliser les ressources du site

- III. Faire une recherche

- IV. Poster une question

- V. Problème résolu

- VI. En résumé

I - Aide aux nouveaux arrivants sur Developpez.com

I-A - Identifier le problème

Avant de chercher une solution à un problème, il faut identifier de manière précise la nature de ce problème. Ce qui peut paraître une évidence semble ne pas aller de soi pour tout le monde.
Un problème bien posé est à moitié résolu.
Il est par exemple inutile de poster sur les forums Delphi, VB ou C++, si l'on a un problème avec une requête SQL même si elle est exécutée à partir d'une application Delphi, VB ou C++.

Cette première approche a trois intérêts majeurs :

1. Elle vous aidera à trouver une solution tout(e) seul(e). Des gens à qui l'on demande d'exprimer clairement leur problème finissent par trouver eux-mêmes ;

2. Elle permettra d'avoir des éléments pour les recherches sur le site ou les forums ;

3. En dernier ressort, elle permettra de poster, le cas échéant, sur le forum adapté et, si les gens comprennent votre problème, ils vous aideront plus volontiers et plus rapidement à trouver la solution.

I-B - Chercher un petit peu

Tout le monde connaît le proverbe « Aide-toi, le ciel t'aidera. » Cette maxime trouve tout son sens ici. Avant de crier à l'aide, il vaut mieux commencer par chercher un peu. Cela permet souvent de trouver plus vite la solution et au pire, cela permettra d'éliminer les mauvaises pistes.

Grâce à la première étape, vous savez où chercher : aide de l'IDE pour la syntaxe, aide du SDK pour les API Windows, aide de votre SGBDR pour la syntaxe des requêtes SQL, ressources en ligne pour de la formation ou du conseil.

La touche F1 est la meilleure amie du développeur, mais beaucoup ne savent pas utiliser l'aide.

À partir de l'énoncé de votre problème, déduisez quelques mots-clés pour la recherche.
Pour illustrer mon propos, je vais utiliser une question qui revient souvent dans le forum Delphi :
« Comment récupérer une chaîne incluse dans une autre ? » A priori, rien à voir avec le SDK, nous allons donc chercher dans l'aide Delphi.
Les mots-clés qui viennent à l'esprit sont « chaîne » et « sous-chaîne » soit en anglais « string » et « substring » (et oui les programmes comprennent parfois mieux l'anglais) si je tape « sous-chaîne » dans la rubrique « index », je n'obtiens rien, pas plus avec « substring ».
J'essaie « chaîne », j'obtiens pas mal de réponses, mais qui ne me satisfont pas (déclaration des chaînes, chaînes à 0 terminal, etc.).
j'essaie « string », je trouve quelques réponses parmi lesquelles « StringOfChar,fonction » elle ne correspond pas exactement à ma recherche, mais cela laisse supposer que je trouverai sur cette page des liens vers d'autres fonctions de chaînes (c'est très courant).
Gagné ! Il y a un lien vers la catégorie « routines de gestion des chaînes » dans laquelle je trouve :

MidStr,fonction
Renvoie la sous-chaîne d'une chaîne d'après la longueur et la position spécifiées.

Si cette méthode n'apporte aucun résultat, je l'applique dans la rubrique « rechercher »: je tape sous-chaîne et MidSTr apparaît parmi une multitude de fonctions similaires.
En moins de deux minutes, j'ai la solution, bien plus rapide que d'attendre une hypothétique réponse sur le forum.
La même méthode fonctionne dans le SDK et ailleurs (en anglais seulement pour le SDK).
Si ces éléments n'ont rien donné, on passe à l'étape suivante.

II - Utiliser les ressources du site

Quel que soit votre problème, dites-vous que d'autres l'ont rencontré, le rencontrent ou vont le rencontrer.

Il a donc certainement déjà été abordé quelque part.

Sur le bandeau de droite de la page d'accueil du site, vous trouverez les liens vers les cours, les comparatifs, les tutoriels.
Cours & Tutoriels

Si vous recherchez des conseils pour un choix (Langage, SGBDR, Environnement, etc.), pensez à consulter les comparatifs. Ils regroupent les tests effectués par les membres du club ainsi que les débats sur divers sujets.
Tests & Comparatifs, Débats.

Si votre question est du type « Comment fait-on ceci avec tel ou tel langage ? »,
consultez la FAQ du langage en question. Elles sont très complètes et bien documentées.
Elles sont accessibles à partir de la page d'accueil ou à partir de l'onglet correspondant au langage.
En fonction des langages, vous pouvez également trouver des codes source.
Les F.A.Q Développeurs

Si vous recherchez une formation complète ou une initiation, les tutoriels sont faits pour vous. Ils sont accessibles à partir de la page d'accueil ou à partir de l'onglet correspondant au langage.

Enfin, si vous recherchez des infos plus ciblées, consultez les sites des membres. Ils sont accessibles à partir de la page « Club ».

Chacun a sa spécialité et vous trouverez l'ensemble de leurs publications.
https://club.developpez.com/sites/

III - Faire une recherche

Si par le plus grand des hasards, vous n'avez pas trouvé votre bonheur, vous pouvez encore faire une recherche à l'aide des mots-clés identifiés lors de la première étape.

En haut à gauche de l'écran d'accueil, vous pouvez rechercher sur developpez.com ou sur les forums.
La première option permet de rechercher parmi les articles, tutoriels, etc. ( au cas où vous n'auriez pas trouvé la bonne rubrique).
La seconde option permet de vérifier sur les forums si quelqu'un n'a pas déjà posé récemment la même question. Si vous êtes membre du club, vous pourrez faire une recherche avancée, à partir de l'index des forums, en précisant le forum concerné par la recherche(SGBD par exemple).

IV - Poster une question

Si vraiment vous n'avez rien trouvé, il ne vous reste plus qu'à poster votre question sur le bon forum.

Comment bien s'y prendre ?

- Choisir le bon forum

Si vous avez suivi les étapes précédentes, cela devrait être simple. Problème de syntaxe=forum du langage, question générale=forum général (choix de langage, SGBD, modélisation, etc.)

- Titre de la question

Résumez INTELLIGEMMENT l'énoncé du problème.
Les messages du type « SVP, au secours, [débutant], etc. » ne servent à rien : la plupart du temps, ils ne sont même pas lus. Évitez également les titres vagues du style « Problème de requête » dans le forum SQL. On se doute que ce n'est pas un problème de C++ (où alors vous postez n'importe où et vous devriez relire les règles du forum) et cela ne donne pas plus envie de lire ni de répondre.

- La question

Évitez absolument le style SMS. C'est insupportable à lire et cela n'aide pas (loin de là) à la compréhension. L'abus d'émoticônes ne facilite pas non plus la lisibilité.
Enfin, utilisez les balises pour rendre vos exemples de code lisibles. Pensez à indiquer les pistes que vous avez explorées, ce que vous avez fait, ce que vous n'avez pas fait. Ce sont autant d'éléments de recherche pour ceux qui vous répondront et cela évitera des solutions que vous avez déjà testées sans succès.

- Le ton

Souvenez-vous des règles du club : soyez poli, évitez d'employer l'impératif, les polices à gros caractères, les couleurs agressives, etc.

V - Problème résolu

Quand votre problème est résolu, pensez à l'indiquer en mettant le tag au bas de la discussion. Pour cela, il suffit de cliquer sur le bouton en bas à gauche.
Cela évitera aux autres de continuer à chercher et cela permettra à quelqu'un ayant le même problème de gagner du temps dans ses recherches.

VI - En résumé

Il s’agit de :

1. Identifiez clairement votre problème.

2. Cherchez un peu par vous-même.

3. Utilisez les ressources en ligne ( les cours et tutoriels, les FAQ, et les autres ressources disponibles dans le menu de la rubrique ou dans la zone de droite des différents portails).

4. Posez la bonne question.

5. Aidez les autres.