Les membres ayant 30 points peuvent parler sur les canaux annonces, projets et hs du chat.
La shoutbox n'est pas chargée par défaut pour des raisons de performances. Cliquez pour charger.

Forum Casio - Autres questions


Index du Forum » Autres questions » [Reverse-Engineering] Comment écrire de la documentation ?
Lailouezzz Hors ligne Membre Points: 91 Défis: 0 Message

[Reverse-Engineering] Comment écrire de la documentation ?

Posté le 03/12/2019 19:59

Bonjour,


Après 1 semaines de recherche j'ai découvert assez de chose pour commencer une documentation, mais j'ai des difficultés dans ce genre de domaine (écrire / expliqué)
Avez vous des conseils à me donner ?


Zezombye Hors ligne Rédacteur Points: 1756 Défis: 13 Message

Citer : Posté le 03/12/2019 20:00 | #


- T'ouvres Microsoft© Word®™
- Tu écris

(tu as des difficultés avec quoi exactement ?)
Divers jeux : Puissance 4 - Chariot Wars - Sokoban
Ecrivez vos programmes basic sur PC avec BIDE
Lailouezzz Hors ligne Membre Points: 91 Défis: 0 Message

Citer : Posté le 03/12/2019 20:01 | #


Zezombye a écrit :
(tu as des difficultés avec quoi exactement ?)

Tout ce qui est expression écrite, comment expliquer une fonction par exemple même si je comprends bien j'ai beaucoup de mal à exprimer/expliquer
Lephenixnoir En ligne Administrateur Points: 24699 Défis: 170 Message

Citer : Posté le 03/12/2019 20:04 | #


Premiers conseils : utilise un éditeur de texte, pas des formats zippés propriétaires.

L'exercice que tu as besoin de pratiquer semble être plus de l'écriture en général que pour la documentation. Ce que tu peux faire c'est ne pas hésiter à écrire beaucoup pour t'assurer que ce que tu veux décrire est effectivement dit. Tu pourras apprendre à être concis plus tard.

Pour le cas particulier des fonctions, tu peux donner des exemples, ou tout simplement paraphraser le code puis relire et expliquer de plus en plus l'idée générale et le pourquoi plutôt que le comment (remontée en abstraction).
Mon graphe (11 Avril): ((Rogue Life || HH2) ; PythonExtra ; serial gint ; Boson X ; passe gint 3 ; ...) || (shoutbox v5 ; v5)
Lailouezzz Hors ligne Membre Points: 91 Défis: 0 Message

Citer : Posté le 03/12/2019 20:05 | #


Lephenixnoir a écrit :
Premiers conseils : utilise un éditeur de texte, pas des formats zippés propriétaires.

L'exercice que tu as besoin de pratiquer semble être plus de l'écriture en général que pour la documentation. Ce que tu peux faire c'est ne pas hésiter à écrire beaucoup pour t'assurer que ce que tu veux décrire est effectivement dit. Tu pourras apprendre à être concis plus tard.

Pour le cas particulier des fonctions, tu peux donner des exemples, ou tout simplement paraphraser le code puis relire et expliquer de plus en plus l'idée générale et le pourquoi plutôt que le comment (remontée en abstraction).

Merci, ça sera noté et appliqué

LienAjouter une imageAjouter une vidéoAjouter un lien vers un profilAjouter du codeCiterAjouter un spoiler(texte affichable/masquable par un clic)Ajouter une barre de progressionItaliqueGrasSoulignéAfficher du texte barréCentréJustifiéPlus petitPlus grandPlus de smileys !
Cliquez pour épingler Cliquez pour détacher Cliquez pour fermer
Alignement de l'image: Redimensionnement de l'image (en pixel):
Afficher la liste des membres
:bow: :cool: :good: :love: ^^
:omg: :fusil: :aie: :argh: :mdr:
:boulet2: :thx: :champ: :whistle: :bounce:
valider
 :)  ;)  :D  :p
 :lol:  8)  :(  :@
 0_0  :oops:  :grr:  :E
 :O  :sry:  :mmm:  :waza:
 :'(  :here:  ^^  >:)

Σ π θ ± α β γ δ Δ σ λ
Veuillez donner la réponse en chiffre
Vous devez activer le Javascript dans votre navigateur pour pouvoir valider ce formulaire.

Si vous n'avez pas volontairement désactivé cette fonctionnalité de votre navigateur, il s'agit probablement d'un bug : contactez l'équipe de Planète Casio.

Planète Casio v4.3 © créé par Neuronix et Muelsaco 2004 - 2024 | Il y a 70 connectés | Nous contacter | Qui sommes-nous ? | Licences et remerciements

Planète Casio est un site communautaire non affilié à Casio. Toute reproduction de Planète Casio, même partielle, est interdite.
Les programmes et autres publications présentes sur Planète Casio restent la propriété de leurs auteurs et peuvent être soumis à des licences ou copyrights.
CASIO est une marque déposée par CASIO Computer Co., Ltd