Commencer à documenter

De Movilab.org

Movilab.org est un wiki. Pour en savoir plus sur ce type d'outil : Qu'est ce qu'un Wiki ?

Cette page vous explique quelles sont les différentes modalités de documentation qui sont proposées ainsi que l'intérêt de documenter via différentes natures de pages puis de créer du lien entre ces ressources.

Pourquoi des pages de formes différentes ?

Cela permet d'avoir un minimum de cohérence dans la présentation des pages qui parlent d'une même chose et cela facilite les modalités de recherches dans le wiki. Cela assure que les pages crées sont bien catégorisées (rangées au(x) bon(s) endroit(s) dans le wiki.)

Les natures de pages

Les natures de pages sont définies par leur forme, elles ne sont pas considérées comme de nature différentes par le Wiki. Leur construction et les informations que l'on renseigne sont différentes en fonction de chacun de ses pages. Pour créer une page cliquer sur créer une ressource.

Architecture movilab.org-min.png

Les tiers-lieux.

Exemple : Le WIP

C'est la page dédiée à la documentation de votre tiers-lieux. Vous pouvez y créer des passerelles avec vos autres ressources (site web, espace de documentation ou de collaboration personnel, etc.) et documenter vos processus d'accueil ou de contributions. Pour les projets que vous menés, les événements ou les thématiques que vous explorez, d'autres pages sont plus adaptées ; l'idée est ensuite de lier votre page "tiers-lieu" à ces autres pages.

Les documents

Exemple : Vivre des communs (présentation Roumics 2017)

C'est la page dédiée à l'import de fichiers et de documents. Vous pouvez aussi créer un document et ajouter des contenus dans la partie éditable de la page comme c'est le cas ici : Partage d'objets (ou déposer le contenu d'un fichier texte dans la partie éditable afin de laisser la possibilité au document de s'améliorer et de vivre).

Les défis

Exemple : Cartographie de Tiers-Lieux

C'est la page dédiée à vos besoins, envies et problèmes. Vous formulez ici un défi que vous cherchez à relever, un problème sur lequel vous cherchez une solution. L'intérêt est de travailler la formulation de votre besoin ou de la problématique et d'inviter les membres de la communauté à proposer des pistes de solutions ou à vous rejoindre autour de ce défi pour chercher à plusieurs.

Les communs

Exemple : Dokos, logiciel libre de gestion et réservation pour tiers lieux

C'est la page dédiée aux ressources (objets, espaces naturels, outils, ensemble de connaissances, etc.) animées par des communautés de contributeurs et qui ont vocation à se développer et à faire bénéficier un maximum de personnes de leurs richesses.

Pour en savoir plus sur ce qu'est un commun : https://lescommuns.org/

Les pages communs peuvent être une des modalités de réponse à des défis.

Créer des liens entres les pages

Si vous mélangez toutes les natures d'informations sur la même page, elles seront plus difficilement retrouvables et vos pages seront moins accessibles et praticables. Vous pouvez créez de nombreux contenus et ensuite vous assurez que l'ensemble de votre documentation est bien interconnectée.

[créer un schéma exemple montrant les liens entre plusieurs pages autour d'une page tiers-lieux]

Comment créer les liens

Commencez par créer vos pages. Ensuite il vous suffit de créer un lien dans la rubrique concernée de votre page principale (celle du tiers-lieu) via la fonctionnalité LIEN de l'éditeur visuel. Dans LIEN INTERNE si vous commencez à taper le nom de votre autre page, le lien apparaît dans le menu déroulant du dessous.

Si vous ne savez pas où insérer les connexions, une solution peut aussi être de créer une section "pages liées" en fin de page et de faire la liste des pages connectées au sujet évoqué. Comme c'est le cas ici : Coremuneration#Autres ressources et pages liées

Créer et lier des catégories

Pour que votre page soit facilement identifiable (notamment par le moteur de recherche) parmi toutes les autres pages du wiki, il faut l'associer à des catégories (géographique, type d'action, événements, lieu/réseau etc...). Pour cela, il suffit simplement d'ajouter le texte suivant : [[Catégorie:Nom]] dans le code source de la page, généralement à la fin (où Nom est le nom de la catégorie dans laquelle vous voulez l'ajouter).

Sur l'éditeur visuel, l'édition des catégories est accessible via le menu "option de page".

Vous pouvez de la sorte créer des catégories qui n'existent pas encore. Elles apparaitront en rouge. Pour les concrétiser, il faut leur créer une page associé (ce que médiawiki vous proposera lorsque vous cliquerez dessus). Si vous créez une nouvelle catégorie, l'idéal est d'ensuite la relié à l'arborescence générale des catégorie. Concrètement il s'agit d'inscrire la nouvelle "page catégorie" dans une catégorie plus large (déjà existante), de la même manière que précédemment.

Essayez d'abord de relier votre page à des catégories qui existent déjà pour éviter du travail d'association supplémentaire. La liste des catégories est accessible dans "farfouiller => ... par catégorie".