Docs.Framasoft.org : un site pour apprendre à utiliser tous nos services !

Temps de lecture 6 min

image_pdfimage_print

Mine de rien, entre les services Dégooglisons Internet et les projets Framasoft, nous maintenons près d’une cinquantaine de sites/projets ouverts au public.

C’est bien joli, mais si on n’accompagne pas ces sites des savoir-faire et outils pour mieux vous aider à vous en emparer… c’est triste, non ?

Un peu de cathédrale dans notre joli bazar…

Depuis près de trois ans que nous Dégooglisons Internet, nous n’aurions rien pu faire sans votre aide. Nous savons que proposer des outils c’est bien, et que cela ne suffit pas. Il faut aussi les présenter, donner des tutoriels, des outils pour les comprendre et les prendre en main.

Bien entendu, ces logiciels sont déjà souvent soutenus par leurs propres communautés, qui proposent leur propre documentation dont chacun·e peut bénéficier. Il nous fallait, néanmoins, un endroit où rassembler tout cela.

Et depuis trois ans, nombre d’entre nous (contributeurs et contributrices, bénévoles et salarié·e·s…) ont apporté leur petite pierre à l’édifice. Il fallait nous voir, à chaque nouvelle contribution, nous émerveiller :

« Chouette ! Arpinux a fait une vidéo de prise en main de Framapic, pour mieux héberger ses images ! »

« Ah ! je me suis bien marré devant la présentation de Framapack que Pyves vient de nous proposer. J’espère que de plus en plus de windowsiens l’utiliseront pour télécharger des logiciels libres… »

« Attend, en plus de coder des fonctionnalités à Nexcloud pour ouvrir Framagenda, Tcit il s’est fadé d’écrire une jolie documentation pour synchroniser ses rendez-vous et ses contacts… GG ! »

« Sérieusement, le groupe Framalang s’est encore surpassé en traduisant la doc de Mattermost… Ça va bien aider à ce que les gens s’emparent de Framateam pour abandonner leurs groupes Facebook. »

« Oh, tu as vu la vidéo de SVTux pour découvrir Framapad ? En deux minutes, on voit que le libre peut faire aussi bien que GoogleDocs. »

« Pouhiou a encore trippé sur sa présentation de Framanotes. J’espère que Turtl aura autant de succès qu’Evernotes… »

« Franchement, les tutos de Cartocité pour utiliser Umap et Framacartes sont excellents… Si ça pouvait libérer les gens de Google Maps… »

(L’est-y pas belle, la vidéo Framalistes de Nicolas Geiger pour le site Colecti.cc ?)

 

Au départ, nous avons essayé de mettre les liens vers ces outils de documentation dans chaque page d’accueil de chacun de nos projets, afin que vous ayez tout sous la main dès que vous commencez à vous y intéresser… Mais souvent, une fois que vous êtes dans le service, vous n’allez plus voir la page d’accueil. On le sait, parce que nous, on fait pareil.

Alors nous avons lancé le défi à JosephK de mettre un peu de cathédrale dans ce merveilleux bazar, et de rassembler nos documentations en un seul et même endroit. N’écoutant que les clapotis de son clavier, ce dernier a décidé de collecter, d’organiser et de présenter tout cela sous la forme d’un gitbook, afin d’avoir un outil que l’on puisse modifier, amender et mettre à jour de façon collaborative (et pas trop ardue).

Demandez la doc !

Le principe est simple : vous cherchez comment utiliser un de nos services ? Pourquoi choisir tel Frama-bidule ? À quoi sert tel Framachin ? rendez-vous sur docs.framasoft.org.

Vous y serez accueillies par un choix de langue (parce qu’un jour, peut-être, on pourrait avoir des versions en anglais, breton ou espéranto).

C’est sommaire, mais éloquent.

Puis sur la page d’accueil, vous verrez une barre latérale qui vous permet de vous guider dans l’ensemble de notre documentation (elle s’adapte selon la rubrique dans laquelle vous vous trouvez). C’est dans la colonne principale, à droite, que se trouvent l’accès aux informations. Tout en haut, vous y trouverez des guides pratiques.

Les deux premiers guides disponibles à ce jour.

Ce sont des guides à destination du grand public, regorgeant d’informations aussi pratiques qu’indispensables. Pour l’instant, nous y avons inclus :

(si vous voulez nous proposer le vôtre, rendez-vous dans la prochaine partie de cet article)

Ensuite, toujours sur cette page, vous y trouverez une liste des services Framasoft.

Tous les services n’y sont pas (encore) présents… alors proposez vos contributions !

Ce sont l’ensemble des services Dégooglisons Internet sur lesquels nous avons une documentation en Français et (plus ou moins ^^) à jour à proposer.

Il vous suffit de cliquer sur le service qui vous intéresse pour découvrir les outils que nous avons pu récolter à son sujet.

Bien entendu, si vous ne trouvez pas votre service préféré et/ou que vous souhaitez proposer un élément de documentation, nous sommes preneurs (voir plus bas).

Enfin, toujours sur cette page, vous y verrez une rubrique « Culture et Logiciels Libres »

Les premiers Frama-Projets à bénéficier de leur documentation !

Ici, vous aurez des savoirs et savoir-faire sur les projets Framasoft qui ne sont pas des services Dégooglisons, qui tendent à promouvoir le logiciel libre et sa culture.

Libre à vous de cliquer et de consulter ce que bon vous semble, et de faire passer les liens à vos ami·e·s, collaborateurs et collaboratrices !

Une documentation qui n’attend que vous

Bien entendu, l’ensemble de ces documents sont libres. Par défaut, la licence utilisée pour les productions Framasoft est la CC-BY-SA, mais prenez soin de vérifier pour chaque outil de documentation, car leurs auteurs et autrices peuvent tout à fait les avoir placé sous une autre licence libre ^^ !

C’est néanmoins une des grandes forces du Libre : n’importe qui peut y participer.

Vous cherchez à soutenir le (logiciel) libre sans forcément savoir coder ? Présentez votre service ou projet favori avec une petite vidéo, une présentation animée, un texte avec captures d’images… Nous vous l’assurons, cela aidera énormément de monde à passer le pas et à adopter du libre dans ses habitudes numériques.

Pour participer, deux cas de figure :

  • Vous connaissez le git, les push et pull request ne vous font pas peur ? : rendez-vous sur la forge de notre gitbook pour proposer vos commits afin que l’on merge tout cela ensemble.
  • Vous n’avez rien compris à la phrase ci dessus ? (ne vous inquiétez pas, celui qui l’a écrite est comme vous !) Rendez-vous sur notre forum des bénévoles, partie tutoriels, pour proposer vos tutos, vidéos, et autres trucs en -os !

Enfin, une manière toute simple de participer, c’est simplement d’aller lire ces petits bouts de savoirs qui aident à mieux se dégoogliser… et de les partager avec son entourage !

Suivre Framasoft:

Réseau d'éducation populaire au Libre. Nous souhaitons faire le trait d'union entre le monde du Libre (logiciel, culturel, matériel, etc.) et le grand public par le biais d'une galaxie de projets à découvrir sur framasoft.org

8 Responses

  1. antistress

    Sérieusement les gars, il faut cliquer sur chaque icône pour avoir le descriptif ? Ca fait combien de clics si je cherche un service précis? Ou alors j’ai loupé un truc ?

    • JosephK

      Bah là on part du principe que tu connais déjà les services en question. Je rappelle que c’est pour apprendre à utiliser un service en particulier, pas découvrir tout ce que Frama propose. Si t’as besoin de la description de chaque service, y a la barre de navigation ou la page d’accueil de Framasoft qui la donne.
      En d’autres termes, docs.framasoft.org n’est pas une porte d’entrée mais bien une porte vers une annexe. L’idée étant que sur chaque service il y ait un lien vers la doc correspondante.

      • Alexis

        Salut,
        superbe initiative, mais j’avoue que je me suis fais exactement la même remarque qu’antistress en voyant ça…

        @ JosephK, ta remarque est très juste, si ce n’est que je m’en suis aperçu qu’en lisant ton commentaire…
        (je parle des infos de la barre de navigation).
        je pense qu’il serait judicieux tant pour https://degooglisons-internet.org/liste que pour https://docs.framasoft.org/fr/ d’avoir là aussi le mini descriptif qui s’affiche lors du passage de la souris.
        Inutile de se donner du boulot sup, il suffirait de reprendre exactement le même contenu…

          • JosephK

            Stop ! Non, Pouhiou.
            Il vaut mieux éviter de faire des copier/coller qui ne seront pas maintenus à jour. Je vais plutôt tenter d’injecter les bulles directement en JavaScript à partir du code de la nav.
            EDIT : C’est fait !

        • Makhai

          Génial comme doc et comme amélioration
          La commu fait une bonne proposition et c’est implémenté super vite *_*
          Je soulève juste un détail, comment on voit ces info-bulle sur mobile ?

  2. Michael

    Bonjour,

    Merci pour le site. Cela m’a permit de découvrir certain services.
    Juste une petite remarque. La bulle descriptif de Framadrive n’est pas la bonne. C’est celle de l’agenda. 😉