La documentation lorsqu'elle fait moins polémique, c'est un peu comme traduire les anciennes écritures avec des termes d'auteur. Le trop grand professionnalisme de certains mots modernes (mais incompris), puisque ces mots sont
communément
rares à entendre . Alors le texte dans la doc doit-il avoir une mise en forme à hauteur professionnelle ou être simplement clair en faisant un ouvrage agréable à lire, à l'inverse d'une longue série d'explication sans possibilité de retour. De retour vers une notion oubliée portée sur une phrase, qui a oubliée de mettre un lien de rafraichissement. Vous savez quand on lit on se perd quelques fois, donc le long texte explicatif ressemble souvent plus à un ring de combat qu'à un conte de fée.
Vous pouvez remettre en cause tout ce qu'il y a en orbite au Python, créer toutes les idées tourbillonnées autour d'un point unique et fixe.
Le Python pour un faible avoir de connaissance, est une pointure tant en usage qu'en esprit. Python a toutes les caractéristiques d'un ouvrage d'auteur génial qui a su reconnaitre ses erreurs, pour en faire une merveilleuse matière aussi solide que de la pierre. Qui détient une politique simple et sans problème, à savoir d'un niveau de discussion voué au code. Le débutant a besoin d'apprendre le Python. - D'une part la documentation réelle de ce langage. Créée par les développeurs Python a été écrite avec des termes techniques, le problème est le nombre d'informations entretenues dans le texte.
Si la documentation originale contenait des exemples simples en plus grand nombre, des bouts de code déterminés à confondre toute illusion d'erreur…
Jusqu'où çà va ?
Tant l'attrait de la transparence maitrisant Python, que d'une transparence enclavée par la maitrise Python.
Quoi d'autre ?
Partager