Bonjour
Il semblerait que le squelette actuellement sur doc.spip.org, n'est
pas la dernière version présente sur la zone.
Cette dernière version semble être intéressante sur au moins la
présentation des tableaux, en les rendant un minimum lisibles.
Il est donc dommage de ne pas pouvoir en profiter :=)
On a regardé avec fil mais c'est un peu le plan galère pour avoir des
droits ftp dessus. Les droits globaux sont, semble t il, ceux de Pif.
Quelqu'un peut faire la mise à jour ? Pif ?
Km
On Thu, 2007-10-25 at 15:29 +0200, cam.lafit@azerttyu.net wrote:
Bonjour
Il semblerait que le squelette actuellement sur doc.spip.org, n'est
pas la dernière version présente sur la zone.
C'est maintenant le cas
l'ancienne version est mise dans squelettes-test/doc_spip_org_old
au cas où car il y a des différences bizarres au niveau de
article-code.html sur les balises #EDIT
On a regardé avec fil mais c'est un peu le plan galère pour avoir des
droits ftp dessus. Les droits globaux sont, semble t il, ceux de Pif.
j'avais pas le choix, sauf à mettre tout en 777 ce qui est moyen.
ou il faut mettre les intervenants dans un groupe commun, mais de toutes
façons c'est toujours galère à gérer
--
À+, Pif.
Génialissime !!!!!
C'est maintenant le cas
Merci Pif
l'ancienne version est mise dans squelettes-test/doc_spip_org_old
au cas où car il y a des différences bizarres [...]
Cool on verra donc à l'usage
> Les droits globaux sont, semble t il, ceux de Pif.
j'avais pas le choix, sauf à mettre tout en 777 ce qui est moyen. [...]
C'était pas une critique, juste un constat. On cherchait alors à
simplifier la chose au lieu de lancer la procédure administrative du
service Spip Secteur "doc.spip.org", département "squelettes" 
C'est pas grave du moment qu'on arrive au bout
Merci encore, ça change la vie de pouvoir lire un tableau
correctement. Pour s'en convaincre la page sur les pipelines est un
bon exemple je trouve.
Km
cam.lafit@azerttyu.net wrote:
C'est maintenant le cas
Merci encore, ça change la vie de pouvoir lire un tableau
correctement. Pour s'en convaincre la page sur les pipelines est un
bon exemple je trouve.
ça redonne envie de le mettre à jour en tout cas.
--
James
James a écrit :
wrote:C'est maintenant le casMerci encore, ça change la vie de pouvoir lire un tableau correctement. Pour s'en convaincre la page sur les pipelines est un bon exemple je trouve.ça redonne envie de le mettre à jour en tout cas. :)
c’est vrai que du coup il en manque quelques uns ( maitenant qu’on les voit )
Petite question, comment contribuer à compléter la doc ?
En effet, je vais souvent sur doc.spip.org pour retrouver une fonction et savoir où elle se trouve. Au fur et à mesure, j'arrive parfois à comprendre ce que font certaines fonctions. Il est clair que les développeurs du core ne peuvent avoir matériellement le temps d'écrire une doc détaillée pour toutes les fonctions.
Par contre, il pourrait y avoir des éléments fournis par d'autres, en plus de l'autodoc. Exemple typique : la fonction liste_rubriques_auteur() était nommée en 1.9.2 auth_rubrique(). Ce petit détail que je suis allé recherché pour mes besoins pourrait venir compléter la doc de cette fonction.
La question est donc de savoir comment d'autres utilisateurs peuvent venir compléter la doc. Ces compléments seraient à distinguer clairement de l'autodoc ou d'une doc officielle vérifiée par des développeurs. Peut-être que les forums associés sont une possibilité. Ou bien avoir recours à Crayons pour des modifs à la wiki. je m'explique.
L'autodoc est stockée dans dans le descriptif des articles. Une doc "officiel" pourrait être stockée dans le texte de l'article et seuls des rédacteurs "officiels" pourrait la modifier. Enfin, une doc collaborative pourrait être stockée dans un autre champs, par exemple le chapo, et cette partie là serait modifiable par tous via crayon. Cela pourrait permettre de constituer un début de documentation pour servir de base à une doc "officiel".
Qu'en pensez-vous ?
PS : je n'aime pas forcément le terme 'officiel'. Ce que je veux dire par là c'est qu'il s'agit d'une information 'vérifiée' par des développeurs de spip qui connaissent donc bien le code. La doc 'collaborative' serait affichée sous réserve, puisque des erreurs peuvent y être présentes. Il s'agit donc d'un embryon de doc sous réserve.
Joseph