Une documentation pour Zaclys

Avatar du membre
did
Messages : 519
Enregistré le : jeu. 18 sept. 2014 20:35

Une documentation pour Zaclys

Message par did »

Salut à tous,

En réponse à https://gazette.zaclys.com/Developpons- ... e,p125,460

Je suis assez motivé par le projet d'une doc type wiki pour Zaclys.
On pourrait, dans un premier temps, y regrouper les différents tutos existants sur le forum et surtout sur le site principal de la mère Zaclys, pour les organiser et les proposer sous une forme plus homogène. Cela permettrait de trouver les infos plus facilement et d'assurer leurs mises à jour plus efficacement.

-- Edit du 10/03/16 --
Point sur l'état d'avancement du projet :
- Un serveur mediawiki a été déployé à cette adresse : http://wiki.zaclys.com/index.php/Accueil
- Une team wiki s'est mise en place, pour vous inscrire sur la liste de diffusion, formulez-en la demande ici : https://www.zaclys.com/Contact,99
- Vous souhaitez participer (rédaction, relecture, etc) ? Manifestez -vous sur ce sujet ou par le formulaire de contact, un compte vous sera créé.

Toute aide, même modeste, est très utile, n'hésitez-pas à nous rejoindre !

Il reste encore pas mal de travail, notamment de relecture. Il s'agit :
- de corriger les coquilles, les erreurs d'orthographe et les mauvaises tournures de phrases ;
- de faire la chasse aux erreurs techniques, aux informations et captures d'écran obsolètes ;
- d'améliorer la mise en page et la présentation ;
- de créer de nouveaux tutos.

Une aide à la rédaction est disponible sur cette page : http://wiki.zaclys.com/index.php/Aide_% ... %A9daction
Olivagne
Messages : 18
Enregistré le : mer. 23 avr. 2014 13:48

Re: Une documentation pour Zaclys

Message par Olivagne »

+1
Excellente idée Did!
Il y a trois sortes d'êtres : les vivants, les morts et les Zaclynautes !
Avatar du membre
root
L'équipe Zaclys
Messages : 646
Enregistré le : mar. 25 mars 2014 16:25
Contact :

Re: Une documentation pour Zaclys

Message par root »

bonjour,

On pense mettre à disposition de la communauté "zaclys wiki" un serveur dédié , comme on a fait jadis pour ce forum

- Dans un 1er temps il faudrait donc discuter de l'outil et des fonctions attendues de cet outil , que pensez vous de Mediawiki ? (https://www.mediawiki.org) , on le retrouve sous nombreux sites de doc en ligne comme par exemple Wikipedia ... Proxmox etc
https://pve.proxmox.com/wiki/Main_Page


- Parallèlement il faudrait parler un peu de la charte graphique et de la possibilité d'utiliser un "theme" ou "skin" sur cet outil : par exemple sur le forum nous avons choisi l'outil phpBB puis nous avons choisi d'acheter et d'installer dessus le theme "Marina Steal" qui est "responsive" (cad compatible smartphone)


- Ensuite il faudrait des volontaires pour piloter / modérer / animer / administrer ce wiki , comme c'est le cas aujourd'hui sur le forum ... là aussi le choix des fonctionnalités du logiciel est important ( pouvoir gérer un groupe d'administrateur, de modérateurs etc)

merci
Avatar du membre
did
Messages : 519
Enregistré le : jeu. 18 sept. 2014 20:35

Re: Une documentation pour Zaclys

Message par did »

Très bien médiawiki, je ne le connais pas plus que ça, mais c'est un outil qui a fait ses preuves.

Concernant la charte graphique, je pensais que se serait bien d'avoir une certaine unité entre la doc et le forum, mais va-t-on trouver un skin mediawiki qui colle avec celui du forum. On peut aussi partir dans une direction graphique différente.

Pour l'équipe, faut voir qui est motivé, on est déjà deux. Ce serait pas mal que tous les membres du forum puissent contribuer et participer à l'écriture du tutos, après il faudrait peut-être définir quelques responsables de l'organisation générale, histoire que ça ne soit pas trop le bazar.
prez
L'équipe Zaclys
Messages : 98
Enregistré le : mar. 25 mars 2014 16:13

Re: Une documentation pour Zaclys

Message par prez »

Bonjour les amis,

un petit tour par ici pour voir où vous en êtes avec le futur Wiki Zaclys.

- Avez-vous opté pour une solution ? Ok pour médiawiki ? Vous avez pu lire ce qui se dit à son propos et ça vous semble bien ?
- Voulez-vous qu'on vous aide à la mettre en place sur le serveur qu'on va lui allouer ?
- Un message particulier à faire passer sur nos réseaux sociaux ?
- What else ?

Concernant la charte graphique, c'est quelque chose qui peut être fait dans un second temps. L'essentiel étant d'avoir un outil pratique pour regrouper toute la doc de nos services.

Concernant le contenu, le mieux c'est de commencer par installer l'outil et d'y placer les tutos existants. De là on pourra annoncer la mise en place du Wiki Zaclys et inviter les utilisateurs à contribuer.

Merci à vous !

Amicalement,
Le Prez
Avatar du membre
did
Messages : 519
Enregistré le : jeu. 18 sept. 2014 20:35

Re: Une documentation pour Zaclys

Message par did »

Bonjour Prez,

Mediawiki me semble bien, je ne sais pas ce qu'en pense Olivagne, nous ne nous sommes pas vraiment concerté pour le moment.
Même chose concernant le déploiement, je ne sais pas si Olivagne veut gérer cette étape. Sinon un peu d'aide ne serait pas superflu, cela nous permettrait de gagner du temps.
Une fois cela en place, un appel à la contribution sur les réseaux sociaux est effectivement une bonne idée.
AlexM
Messages : 25
Enregistré le : dim. 25 oct. 2015 15:45

Re: Une documentation pour Zaclys

Message par AlexM »

Je peux aider soit pour le déploiement soit pour participer...
prez
L'équipe Zaclys
Messages : 98
Enregistré le : mar. 25 mars 2014 16:13

Re: Une documentation pour Zaclys

Message par prez »

Très très bonne nouvelle AlexM ! Merci.

Je vais de ce pas vous demander un petit serveur pour que vous puissiez déployer la solution retenue et la tester avec l'équipe wiki : did, Olivagne et vous pour l'instant.

Il est toujours possible de rejoindre cette équipe. Nous aurons besoin de monde pour transférer la doc existante vers ce wiki. Puis pour la faire évoluer et la maintenir.


Amicalement,
Le Prez
Avatar du membre
did
Messages : 519
Enregistré le : jeu. 18 sept. 2014 20:35

Re: Une documentation pour Zaclys

Message par did »

Toujours partant.
Vous installez mediawiki ou on le fait ? Olivagne, tu connais cette doc ?
Gord's
Messages : 150
Enregistré le : jeu. 23 juil. 2015 07:51

Re: Une documentation pour Zaclys

Message par Gord's »

Bonjour

Je peux relire, et adapter pour mac osx (yosemite) si besoin, avec FF et Safari.
Répondre

Retourner vers « Wiki »