Discussion :

[hansaplast]

Bonjours, je decouvre ce merveuilleux outil qu'est phpdocumentor!

une question me taraude quand meme les quelques neuronettes qu'il me reste...
la doc de phpdocumentor, faite avec cet outil, possede un message d'accueil pour chaque package...

et je ne voit vraiment pas, mais alors vraiment pas, comment on fait...

pourl'instant, j'ai commenté mes classes, mes pages, mes includes...

mais ca manque de recapitulatif...

par exemple, la doc de phpdoc couvre sur "how to create great doncumentation"...
si quelqu'un savait faire ca...

j'ai bien essayé de créer un repertoire "tutorials" a la racine de mon rep... d'y placer un fichier portant le nom du package par defaut : "default.pkg" et d'y mettre de la doc :

<refentry id="{@id}">
<refnamediv>
<refname>documentation de ECOMED version php</refname>
<refpurpose>aide au re-developpement, en partant de l'acquis de celui ci</refpurpose>
</refnamediv>
<refsynopsisdiv>
<author>....

mias ca ne marche po :'(

[hansaplast]

sinon, existe t il un site d'information/de news sur cet outil, en francais?
j'avoue que je n'aprehende pas bien toutes les notions lorsque je lit de l'anglais... (deja que j'ai pas tout le vocabulaire informatique ne francais...)

[hansaplast]

tout ce que je veut faire, c'est afficher un paragraphe d'introduction, a la page d'accueil de chaque package, personne sait faire?

[Mr N.]

Personne n'ecrit de doc, c'est ceux qui n'ont rien à faire qui écrivent de la doc
Désolé de pas pouvoir t'aider, je ne me suis jamais servi de ce genre d'outil Et la consultation de leur doc ne m'a pas inspiré...

[hansaplast]

Personne n'ecrit de doc, c'est ceux qui n'ont rien à faire qui écrivent de la doc

tout a fait d'accord :'(

apres un an de dev,
une version windev,
une version php,
on me dit qu'on va confier ca a un prestataire externe,
car je aprt dans 6 mois, et y'a pas d'autres developpeurs...
donc je documente :'(

ca me deprime

pour mon pb :

alors : http://manual.phpdoc.org/HTMLSmartyC...rials.pkg.html

il faut suivrze l'arborsecence suivante :

tutorial\<nomPackage>\<nomPackage>.pkg
tutorial\<nomPackage>\<nomPackage>.pkg.ini

et dans "tutorial\<nomPackage>\<nomPackage>.pkg"
=> suivre le format XML DocBook (lisez la doc de phpdocumentor pour voir les tags )

voila