• [^] # Re: Doc en Français

    Posté par . En réponse à la dépêche Seaside 2.8 est sorti. Évalué à 4.

    En fait, si tu codais en Smalltalk comme en Java ou en PHP, ta remarque serait tout à fait valable. Sauf qu'en Smalltalk (avec les IDE comme Squeak ou Cincom Smalltalk), tu as accès au code des bibliothèques que tu utilises aussi facilement qu'à ton propre code.

    Je veux bien, c'est pratique quand tu sais quelle classe utiliser. Pour en revenir à ma comparaison avec l'elecronique, si tu as besoin d'un élément qui réalise une amplification de courant, tu sais que tu dois utiliser un transistor, et tu sais à partir de ton besoin, quel transistor tu vas choisir ( éventuellement tu fais un petit montage avec appareils de mesure pour vérifier ton choix, ou tu utilises un simulateur).

    Ce qui fait que quand tu souhaites utiliser une classe, tu commences par ouvrir un navigateur de code sur cette classe et tu peux voir immédiatement son commentaire et ses méthodes.

    Le problème se pose dans le cas inverse: tu veux effectuer une opération mais tu ne sais pas quelle classe utiliser: il est un peu fastidieux d'ouvrir les classes une à une pour s'y retrouver. Pour Seaside c'est encore pire, a l'époque ou j'ai tenté de l'utiliser (6 mois environs), même le code n'était pas documenté.
    C'est un des gros avantages par rapport à une approche de type documentation séparée : on a la doc et le code juste sous la main pour bien voir ce qui se passe.

    C'est pratique mais incomplet à mon avis, surtout pour débuter.