bonjour, Qu'utilisez vous pour gérer les documentations/procédures techniques destinées à vos collègues ? et redigées par plusieurs personnes et avec du versionning ? merci
Bonjour, le module Wiki de Redmine... vu qu'on utilisait déjà Redmine pour la gestion des tâches. Olivier On 08/10/2012 19:41, Christophe Dezé wrote:
bonjour, Qu'utilisez vous pour gérer les documentations/procédures techniques destinées à vos collègues ? et redigées par plusieurs personnes et avec du versionning ?
merci _______________________________________________ Liste de diffusion du FRsAG http://www.frsag.org/
Bonjour, Nous on utilise le combo sphinx et github, pour la doc produit et interne : Le Github de la doc produit : https://github.com/alchemy-fr/Phraseanet-Docs La doc produit finale : https://docs.phraseanet.com/3.7/fr/ Le site de sphinx : http://sphinx.pocoo.org/ Ca passe par le système de pull request de github. C'est du rst, la doc est vachement simple à écrire. Cdlt, Jonathan "bartoua" SCHNEIDER Le lundi 8 octobre 2012 19:41:29, Christophe Dezé a écrit :
bonjour, Qu'utilisez vous pour gérer les documentations/procédures techniques destinées à vos collègues ? et redigées par plusieurs personnes et avec du versionning ?
merci _______________________________________________ Liste de diffusion du FRsAG http://www.frsag.org/
Bonjour, Pour notre part nous utilisons svn+tracc et depuis quelques mois Redmine pour la gestion de projet binder sur le svn. Pour la doc pur, on a un dokuwiki. Le tout hébergé sur du Ubuntu Server. David Le 8 octobre 2012 19:46, Jonathan SCHNEIDER <bartoua@gmail.com> a écrit :
Bonjour,
Nous on utilise le combo sphinx et github, pour la doc produit et interne : Le Github de la doc produit : https://github.com/alchemy-fr/** Phraseanet-Docs <https://github.com/alchemy-fr/Phraseanet-Docs> La doc produit finale : https://docs.phraseanet.com/3.**7/fr/<https://docs.phraseanet.com/3.7/fr/> Le site de sphinx : http://sphinx.pocoo.org/
Ca passe par le système de pull request de github. C'est du rst, la doc est vachement simple à écrire.
Cdlt, Jonathan "bartoua" SCHNEIDER
Le lundi 8 octobre 2012 19:41:29, Christophe Dezé a écrit :
bonjour,
Qu'utilisez vous pour gérer les documentations/procédures techniques destinées à vos collègues ? et redigées par plusieurs personnes et avec du versionning ?
merci ______________________________**_________________ Liste de diffusion du FRsAG http://www.frsag.org/
______________________________**_________________ Liste de diffusion du FRsAG http://www.frsag.org/
On Mon, Oct 8, 2012, at 07:41 PM, Christophe Dezé wrote:
bonjour, Qu'utilisez vous pour gérer les documentations/procédures techniques destinées à vos collègues ? et redigées par plusieurs personnes et avec du versionning ?
Une forme ou autre de wiki ? Pour ceux qui sont rattrapes par l'ITIL-isme un repertoire partage sur le file-server (le wiki restant generalement LE moyen de trouver quel est le fichier sur le FS qui contient la preocedure). Apres, je ne crois pas qu'il y a d'outil magique. Pour avoir utilise des wiki depuis bientot 10ans, j'ai pu constater qu'exactement le meme outil peut etre la bonne solution et la mauvaise solution, en fonction de la facon dont il est utilise. en general vouloir garder une doc utilisable est primordial. Avoir quelqu'un qui l'impose et qui suit que ca soit respecte peut aider aussi enormement.
Si on parle des docs et supports techniques générales et pas que des documentations de codes, je partage l'avis de Radu-Adrian, un bon partage réseau bien structuré peut suffire. Sinon le cloud façon Google Drive c'est bien aussi. Pour le "versionning", autant appliquer des méthodes qui fonctionnent : l'ISO 9001:2008 est fait pour ça, qui plus est, ça permet de s'aligner sur le plan qualité de l'entreprise quand cette dernière en est doté. Et toujours penser qu'on peut se retrouver en situation de crise avec un black-out total donc moi je conseille d'imprimer toutes les docs à jour et les ranger dans la vraie vie dans de vrais dossiers. C'est aussi ISO 9001 mais pas ISO 14001, je m'excuse pour la planète mais je n'ai pas trouvé mieux. Bonne journée à tous, Olivier Le 8 octobre 2012 21:21, Radu-Adrian Feurdean < frsag@radu-adrian.feurdean.net> a écrit :
On Mon, Oct 8, 2012, at 07:41 PM, Christophe Dezé wrote:
bonjour, Qu'utilisez vous pour gérer les documentations/procédures techniques destinées à vos collègues ? et redigées par plusieurs personnes et avec du versionning ?
Une forme ou autre de wiki ? Pour ceux qui sont rattrapes par l'ITIL-isme un repertoire partage sur le file-server (le wiki restant generalement LE moyen de trouver quel est le fichier sur le FS qui contient la preocedure).
Apres, je ne crois pas qu'il y a d'outil magique. Pour avoir utilise des wiki depuis bientot 10ans, j'ai pu constater qu'exactement le meme outil peut etre la bonne solution et la mauvaise solution, en fonction de la facon dont il est utilise. en general vouloir garder une doc utilisable est primordial. Avoir quelqu'un qui l'impose et qui suit que ca soit respecte peut aider aussi enormement. _______________________________________________ Liste de diffusion du FRsAG http://www.frsag.org/
Le Tue, Oct 09, 2012 at 08:57:39AM +0200, Olivier MARECHAL [omarechal@gmail.com] a écrit: [...]
Et toujours penser qu'on peut se retrouver en situation de crise avec un black-out total donc moi je conseille d'imprimer toutes les docs à jour et les ranger dans la vraie vie dans de vrais dossiers.
Un wiki avec un backend dans un VCS (comme ikiwiki) et/ou avec des données stockées dans le filesystem (comme dokuwiki), et une synchro quotidienne, ça permet d'en conserver autant de copies que nécessaires pour le jour de crise, facilement lisibles. -- Dominique Rousseau Neuronnexion, Prestataire Internet & Intranet 21 rue Frédéric Petit - 80000 Amiens tel: 03 22 71 61 90 - fax: 03 22 71 61 99 - http://www.neuronnexion.coop
Le 09/10/2012 09:54, Dominique Rousseau a écrit :
Le Tue, Oct 09, 2012 at 08:57:39AM +0200, Olivier MARECHAL [omarechal@gmail.com] a écrit: [...]
Et toujours penser qu'on peut se retrouver en situation de crise avec un black-out total donc moi je conseille d'imprimer toutes les docs à jour et les ranger dans la vraie vie dans de vrais dossiers. Un wiki avec un backend dans un VCS (comme ikiwiki) et/ou avec des données stockées dans le filesystem (comme dokuwiki), et une synchro quotidienne, ça permet d'en conserver autant de copies que nécessaires pour le jour de crise, facilement lisibles.
Nous on a imprimé les docs qui permettent de revenir à l'état ou on peut accéder au wiki: 10 pages max, pas de quoi imposer des cours de nage aux ours polaires.
On mar. 09 oct. 2012 11:30:38 CEST, Gaëtan Duchaussois wrote:
Le 09/10/2012 09:54, Dominique Rousseau a écrit :
Le Tue, Oct 09, 2012 at 08:57:39AM +0200, Olivier MARECHAL [omarechal@gmail.com] a écrit: [...]
Et toujours penser qu'on peut se retrouver en situation de crise avec un black-out total donc moi je conseille d'imprimer toutes les docs à jour et les ranger dans la vraie vie dans de vrais dossiers. Un wiki avec un backend dans un VCS (comme ikiwiki) et/ou avec des données stockées dans le filesystem (comme dokuwiki), et une synchro quotidienne, ça permet d'en conserver autant de copies que nécessaires pour le jour de crise, facilement lisibles.
Nous on a imprimé les docs qui permettent de revenir à l'état ou on peut accéder au wiki: 10 pages max, pas de quoi imposer des cours de nage aux ours polaires. _______________________________________________ Liste de diffusion du FRsAG http://www.frsag.org/
Dans les 10 pages, il y a tout ce qu'il faut pour remettre le reseau en route, reinstaller la machine car tout les disques sont morts, reinstaller from scratch le serveur de backup, et le contact de la boite qui relivre la bande de sauvegarde ?
On Tue, Oct 9, 2012, at 03:32 PM, Sébastien FOUTREL wrote:
Dans les 10 pages, il y a tout ce qu'il faut pour remettre le reseau en route, reinstaller la machine car tout les disques sont morts, reinstaller from scratch le serveur de backup, et le contact de la boite qui relivre la bande de sauvegarde ?
Si tu n'est pas dans un environnement totalement delirant, tout remonter pour que ca soit accessible *d'une facon ou autre*, ca doit etre possible en 10 pages, voir meme mois. On ne parle pas la de comment remonter son infra interne en 10 pages, juste remonter la base documentaire, qui est le pre-requis pour re-monter le reste.
Publican (https://fedorahosted.org/publican/ il y a un package sur quasi n'importe quelle distrib) + version/collab via Git Faut assimiler les conventions docbook, mais ça permet de se concentrer sur l'essentiel, d'inclure facilement des tronçons de doc des voisins et de traduire le tout à coup de .pot. Rendu => Html single/multi, pdf (et man de mémoire) Le 9 octobre 2012 21:27, Radu-Adrian Feurdean < frsag@radu-adrian.feurdean.net> a écrit :
On Tue, Oct 9, 2012, at 03:32 PM, Sébastien FOUTREL wrote:
Dans les 10 pages, il y a tout ce qu'il faut pour remettre le reseau en route, reinstaller la machine car tout les disques sont morts, reinstaller from scratch le serveur de backup, et le contact de la boite qui relivre la bande de sauvegarde ?
Si tu n'est pas dans un environnement totalement delirant, tout remonter pour que ca soit accessible *d'une facon ou autre*, ca doit etre possible en 10 pages, voir meme mois. On ne parle pas la de comment remonter son infra interne en 10 pages, juste remonter la base documentaire, qui est le pre-requis pour re-monter le reste. _______________________________________________ Liste de diffusion du FRsAG http://www.frsag.org/
-- *Pierre De Paepe* 5, rue Gustave Doré 75017 Paris 06.76.20.23.58
On mar. 09 oct. 2012 11:30:38 CEST, Gaëtan Duchaussois wrote:
Le 09/10/2012 09:54, Dominique Rousseau a écrit :
Le Tue, Oct 09, 2012 at 08:57:39AM +0200, Olivier MARECHAL [omarechal@gmail.com] a écrit: [...]
Et toujours penser qu'on peut se retrouver en situation de crise avec un black-out total donc moi je conseille d'imprimer toutes les docs à jour et les ranger dans la vraie vie dans de vrais dossiers. Un wiki avec un backend dans un VCS (comme ikiwiki) et/ou avec des données stockées dans le filesystem (comme dokuwiki), et une synchro quotidienne, ça permet d'en conserver autant de copies que nécessaires pour le jour de crise, facilement lisibles.
Nous on a imprimé les docs qui permettent de revenir à l'état ou on peut accéder au wiki: 10 pages max, pas de quoi imposer des cours de nage aux ours polaires. _______________________________________________ Liste de diffusion du FRsAG http://www.frsag.org/
Dans les 10 pages, il y a tout ce qu'il faut pour remettre le reseau en route, reinstaller la machine car tout les disques sont morts, reinstaller from scratch le serveur de backup, et le contact de la boite qui relivre la bande de sauvegarde ? :D
participants (10)
-
Christophe Dezé -
David RIBEIRO -
Dominique Rousseau -
Gaëtan Duchaussois -
Jonathan SCHNEIDER -
Olivier Bonvalet -
Olivier MARECHAL -
Pierre De Paepe -
Radu-Adrian Feurdean -
Sébastien FOUTREL