Gestion des versions de documentations, avant tout

Bonsoir,
Et Bravo pour ce Zora que je re-decouvre !
j'ai un peu de mal a suivre (prenant le train en marche): excusez si j'ai des reflexions HS

Le 19/03/2013 13:52, Ybbet Spip a écrit :

Le 19 mars 2013 13:07, Matthieu Marcillaud <marcimat@rezo.net <mailto:marcimat@rezo.net>> a écrit :

    Face à ce bel écho, je livre mes réponses :slight_smile:

    Le 18/03/2013 12:55, Matthieu Marcillaud a écrit :

        Questions en vrac :

        A) que manquerait t'il pour sa mise en ligne ?

    Ce que je pense, c'est que, c'est déjà mieux qu'avant, et que
    donc, bah, ce qui est fait et fait qu'on peut le mettre en ligne ?

C'est tres intéressant et facile d'usage,mais je garde avec bcp d'interet certains articles -rédiges- anciens de doc.spip.org, car ils expliquent bien certaines choses....
Quant à "eliminer" des indications de Programmer (lu dans un autre msg), pitié non !
C'est déja assez difficile a comprendre parfois, meme avec l'aide de magraine !

Si la doc de SPIP n'est conçue que pour ceux qui savent déjà,
       SPIP ne perdurera pas.... :frowning: :frowning: :frowning:

    B) gère t'on les traductions sur le SPIP ? si oui, comment ?

    Oui, les APIs c'est de la doc technique pour tous, donc dans
    plusieurs langues.

+1 .. si on peut !

Sur ce dernier point, cela rejoindrait ton avis sur le fait de ne pas ré-écrire un article sur une fonction d'une version à une autre alors que "rien" n'a changé entre ces 2 versions données.

On pourrait faire en sorte qu'il y ait un "mot-clé" par version qu'on attribut à chaque article...
C'est dans la même lignée de ce qui s'est fait sur spip.net <http://spip.net> pour la doc mais n'a jamais été exploité.

    l'usage complet des mot-cles est rarement utilisé (cf. aussi
    contrib..) !
    Bravo de remettre en bon usage...

        D) sur l'autodoc (qui n'a pas de traduction), gère t'on
        différentes versions de SPIP, si oui, comment ?

    Je pense que l'autodoc est quelque chose exclusivement pour les
    développeurs et que... partant de ce point de vue, il serait
    inutile de faire afficher différentes versions, mais uniquement la
    dernière version en développement.

Developpeurs... de SPIP ou plugins ?
     ou cela concerne-t-il aussi les utilisateurs avancés webmestres-codeurs ?
Je militerai pour ne pas oublier les seconds....

--
YannX
http://spippourlesnuls.fr

Ils y sont :slight_smile: Mais ils sont un peu périmés. Je les ai dans une rubrique «Archives» Il ne s’agit pas d’éliminer, mais de déplacer :slight_smile: La nuance est importante. Ceux qui savent déjà n’ont pas besoin de doc. Effectivement on peut. Après… est-ce réellement utile… Disons que ça concerne ceux qui ont besoin de toucher à du code PHP pour faire des choses avec SPIP, appelle les comme tu veux, peu importe. MM.