Salut,
J'ai un petit dilemme pas bien insurmontable, mais je préfère demander tout de même 🙂
Je voulais essayer un jeu, Rigs of Rods (RoR) pour ne pas le citer ^^ , et j'ai suivi la documentation sur le wiki d'Ubuntu-fr.org (qui est "déjà" bien faite).
La documentation existe déjà, et reprend mot pour mot celle du site officiel mais avec l'avantage d'être en français ici.
Jusque ici tout va bien donc !
Problème :
J'ai suivi la doc à la lettre, mais j'ai rencontré énormément de soucis de lors de la compilation... : "
pas de paquet trouvé", "
compilation impossible", "
compilation interrompue par manque de ...", etc....
Je suis alors retourné sur le site officiel, pour y voir qu'en effet, il y a tout un lot de paquets/logiciels tiers à installer pour permettre uniquement : la compilation.
Et il y en a un paquet, pas moins de 12 ou 13 en théorie si mes souvenirs sont bons.
Je vais donc tenter l'installation de ce jeu/simulation en suivant toutes ces procédures données sur le site officiel (installation des 12-13 paquets/logiciel + compilation + installation).
Petite précision :
Le site officiel annonce que pour le moment, le jeu est déclaré fonctionnel pour xUbuntu en 10.04 (mais rien pour la 11.XX).
Je suis en 11.10, et je souhaite tout de même tenter la manip ... Je suis joueur (lol)...
La doc Fr est quant à elle faite, il me semble pour Karmic.
Dans le cas, où je réussi l'installation en suivant la procédure complète, je souhaite évidemment partager ce retour d'expérience sur le documentation... et ainsi proposer l'intégralité de la procédure en Français, chose qui devrait plaire au plus grand nombre vu que ce jeu/simulation semble
(pas eu encore le plaisir de l'essayer) être une petite merveille.
Alors j'ai deux possibilités :
- Soit modifier la documentation existante, en y ajoutant tout ce lot de procédure d'installation a effectué.
- Soit re-créer une autre page "tuto" qui serait liée à cette page de documentation.
Je suis déjà un habitué des Wiki de manière générales, et de celui d'Ubuntu-fr (même si je n'y ai fait/participer que 4 ou 5 docs).
Habituellement, je me contente de faire les ajouts sur la page existante, mais ici, le chantier semble assez lourd à mettre en œuvre et je ne sais pas si la documentation telle qu'elle est actuellement fonctionne réellement (même pour les utilisateurs de Karmic).
C'est la-dessus qu'est mon dilemme.
Si la documentation FR, telle qu'elle existe, suffit pour que RoR fonctionne pour les utilisateurs de Karmic et "avant", il est peut-être dommage de rajouter tout un lot de procédures à faire pour les utilisateurs de versions antérieure, et qui ferait une paaaaaage à rallooooooooonge uniquement pour quelques utilisateurs.
Mais je dois avouer aussi que je me demande comment des utilisateurs de Karmic peuvent faire fonctionner le jeu sans installer tous les pré-requis au préalable, alors que ces logiciels ne semblent pas être installés dans xUbuntu par défaut, ne même faire partis des dépôts, et que l'installation des dépendances requises, ne semble pas comporter tous ces "pré-requis de compilation".
Attention :
Je ne parle pas des dépendances/libraires à installer au début de l'installation, qu'on peut voir sur le Doc actuelle; Dépendances/librairies qui nous font d'ailleurs télécharger et installer près de 140 Mo.
Mais là je parle bien de logiciels/librairies permettant la compilation de RoR tels que
(je balance la liste complète lol) : Ogre, Mygui, Freeimage, OIS, Paged Geometry, Caelum, My SocketW, LUA, AngelScript, OpenAl, WxWidgets, et Hydrax (voilà je crois que c'est tout....).
D'ailleurs on peut avoir une idée des logiciels/librairies/plate-forme que RoR a besoin lors de sa compilation, quand on parcours l'archive des sources de RoR, où l'on peut justement y voir des fichiers "
conçut pour/réalisé à partir de" tous ces pré-requis.
----
Voilà, avec tous ces éléments de "connaissance" de la situation, voilà pour résumer mon dilemme :
1.
Soit la documentation actuelle est viable (et permet donc de faire fonctionner le jeu pour les utilisateurs de Karmic (et avant)) :
-Vaut-il mieux ajouter toute la procédure d'installation des paquets/librairires/ligiciel requis (uniquement) pour la compilation, au sein même de la doc actuelle, même si cela ne concernerait qu'une partie des utilisateurs ?
-Ou mieux vaut-il finalement créer une autre page, dans la partie tutoriel (du wiki) cette fois, pour expliquer pas-à-pas cette procédure complète à mettre en œuvre, pour ensuite pouvoir continuer le processus d'installation (qui lui se trouve et se trouvera toujours dans "sa" page actuelle, à la "Racine" du Wiki)... ?
Les deux pages seraient évidemment liées, et j'ajouterai dans la doc actuelle, une ligne du type :
Si vous êtes sur un version de xUbuntu supérieure à Karmic, vous êtes invités à parcourir cette page (lien vers Wiki:Tutoriel:Compilation_RoR), pour installer l'ensemble des pré-requis exigés pour la phase de compilation, et de revenir ensuite sur cette page (Wiki:RoR) pour finaliser l'installation.
J'ai déjà fait ce genre là sur le wiki, lorsque j'avais créé une page pour installer une "extension" qui demande une installation "assez lourde" à un logiciel déjà existant. La page de doc du logiciel est sur la racine du wiki, puis la page concernant l'extension, est créée dans la partie Tutoriel.
L'exemple sur le fond est différent, mais sur le forme cela revient au même, et je pense que cette "solution" de bien partager la doc "générale" et le Tuto (plus spécifique) permet une meilleure clarté mais aussi d'organisation du Wiki, aussi bien pour les contributeurs (en partant du principe qu'ils ont compris et qu'il adhèrent au principe) que pour les lecteurs.
2.
Soit la documentation actuelle n'est pas viable (et ne permet donc de faire fonctionner le jeu pour les utilisateurs de Karmic (et avant)) :
Dans ce cas, la question ne se pose même pas, autant refaire la page de doc actuelle, avec toute la procédure.
----
Vous l'avez compris, cette(ces) question(s) concerne(nt) :
- Certes les joueurs de RoR, qui jouent à RoR et qui ont donc installé RoR via la doc sur Ubuntu-Fr.org (et utilisant Karmic), afin de savoir si la procédure telle qu'elle est sur le doc est fonctionnelle,
- Mais aussi les contributeurs "avertis" (je ne sais pas s'il y a une équipe "responsable" de l'organisation du wiki), car ce dilemme ici pour RoR peut l'être aussi dans d'autres cas et pourrait donc être généralisé.
Donc, bref, il n'y a rien d'insurmontable dans cette situation, je pense sur bénéfice du doute me contenter de le faire "à la suite" de la doc existante... mais pour un soucis de perfectionnisme, je me demande s'il ne serait pas mieux de faire une page "tuto" uniquement pour la procédure d'avant-compilation.
Bon... et puis je crée ce sujet sans avoir commencé/testé la procédure "d'avant-compil" (avec la 11.10).... et... si ça se trouve.... ça ne marchera pas (lol)...
Mais la question reste ouverte pour d'autres docs (puisque je me suis déjà posé la question à plusieurs reprises, surtout lorsque je vois des pages de Doc à rallonge uniquement parce que d'une version à l'autre, il y a des "choses" à ajouter, et qui finalement pour un soucis de clarté (et éviter les erreurs de lectures), ces ajouts "spécifiques" seraient mieux dans une page "tiers" dans la section "tuto".
Bonne journée et bon dimanche, désolé d'avoir fait long ...... (mais ça vous donne l'image qu'aura la Doc après mes ajouts sur la doc actuelle 😛, si ajouts il y a).
Merci par avance pour vos réactions 🙂
@+
Ps:
Voici quelques liens :
-
Doc actuelle dédiée à RoR (à la racine du wiki) | Wiki - Ubuntu-fr.org
-
La "même" mais sur le site officiel (en Anglais) | http://www.rigsofrods.com
-
Procédure d'installation pour préparer la compilation (en anglais) | Wiki du site officiel | http://www.rigsofrods.com (c'est celle-ci que je vais tester, traduire ensuite en Fr et l'adapter pour le wiki d'Ubuntu-fr.org, et pour laquelle je me demande si elle ne devrait pas plutôt être sur une page "tiers" dans la partir Tuto du wiki (de la même manière que sur le Wiki officiel de RoR finalement).