• [^] # Re: Code auto-documenté

    Posté par (site web personnel) . En réponse au journal To comment or not to comment. That is the question.. Évalué à 5.

    Pas mal de choses à dire en fait, mais j'aime beaucoup la tournure que ça prend :)

    Déjà, j'aime pas tellement ni le côté "dense" sans accolades, ni l'absence de point virgule. (ni le passage du goog en fait)

    Ça, c'est fait :)

    Ensuite, honnêtement, je trouve ça plus lourd. Et surtout, il manque réellement des commentaires.
    En fait, en lisant ton code, on ne sait toujours pas pourquoi on teste l'état du document, pourquoi un lance une erreur mais pas dans le cas de deps.js.

    Donc en fait, ton code factorisé de la sorte n'amène pas de réponses, il serait même à mon avis plus compliqué de décrire les cas (car tu as changé l'ordre des conditions, même si ça ne change pas le résultat).

    Et au final je trouve ça moins lisible car cela oblige à faire des allez retour.

    Finalement j'aime bien cet exemple car c'est justement un vrai cas où ce qui est intéressant est le pourquoi et non le comment (le comment est très simple, le pourquoi beaucoup plus tordu).