++++++++++++++++++++++++++++++++
Documenter *
++++++++++++++++++++++++++++++++

.. include:: ../volabid.rst

:Date: Novembre 2019
:mise à jour: 13/01/2023

.. toctree::
   :maxdepth: 2
   :caption: Sous articles
   :titlesonly:

   /sphinx/sphinx
   /latex/latex
   /pandoc/pandoc

.. contents::

================================
Cartes Heuristiques
================================
Ou Mind mapping

Wikipédia propose une `liste de logiciel`_

.. _`liste de logiciel` : https://fr.wikipedia.org/wiki/Carte_heuristique



Freeemind : open source mais les développements sont un peu au ralenti, la dernière version date de 
2013

`XMind`_ : logiciel propiétaire Xmind Ltd. mais propose une version gratuite

.. _`XMind` :  https://www.xmind.net/fr/

framamind : en ligne (donc pas pour moi)

Je recherche un outil en ligne capable d'importer du XMIND

Il y a aussi `Freeplane`_, un fork de Freemand plus abouti

.. _`Freeplane` : https://docs.freeplane.org/


================================
Documenter un projet
================================
Etat d'avancement: après avoir fortement utilisé Libreoffice et les cartes heuristiques avec 
Feemind d'abord puis avec Xmind, aujourd'hui, vrai en 2023, j'utilise de préférence Sphinx et les fichiers 
Restrucured Text.

J'ai abandonné Xmind pour la prise de notes car il produit des fichiers beaucoup trop long à ouvrir.

Le gros avantage des fichiers rst est que cela reste des fichiers texte simple donc versionnable
facilement sous git/github.

Pour versionné le code, j'utilise le git associé à Github. Se pose alors à moi le problème de la 
notion de projet. Que faut-il versionné ? Exemple: le projet DCC++ sur lequel nous travaillons.
Il s'agit d'un grand projet dans lequel sont apparus de petits sous projet.

Comment faut-il versionné tout cela ? Un gros monolithe ou plein de petits projets ?

Je n'ai pas encore (Février 2020 puis en Janvier 2023) trouvé de réponse satisfaisante...

----------------------------------------------------------------------------------------------------

.. index::
    single: Documenter; MOOT

====================================================================================================
MOOT
====================================================================================================
7 Mars 2020, en cherchant pour la nième fois des éléments de syntaxe Sphinx, je tombe ce ce site:

`ReFlexPro, Univ. Grenoble Alpes`_ même si le début est brouillon et semble-t-il en cours de 
construction;, la suite en vaut la peine !

.. _`ReFlexPro, Univ. Grenoble Alpes` : http://espe-rtd-reflexpro.u-ga.fr/docs/sandbox2/fr/latest/essais_sophie.html

Cela me conforte dans mon cheminement.

Après une rapide recherche sur le net, il semble que l'acronyme MOOT ne soit pas très répendu, mais
j'aime concepte.

On parle également de Open Text tout simplement.




====================================================================================================
Weblinks
====================================================================================================

.. target-notes::