As reported by Bastien, I started a documentation for the current state of the citation engine(s). I intended to complete it, but got "a little" sidetracked.
Enclosed is a patch of where I was in August.
Bastien made the following remarks, which I mostly intended to follow :
===========================================
Je pense qu'à ce stade, le mieux est de soumettre ce document sur la
liste de diffusion.
En attendant, j'ai quelques remarques, en vrac :
- Je pense que le titre "Working with…" n'est pas assez explicite. Par
ailleurs, le chapitre précédent commence aussi par "Working with…".
Par conséquent, je propose d'intervertir la description et le titre :
* Citations and references
:PROPERTIES:
:DESCRIPTION: Working with other people's work
:END:
- Il faut penser à mettre deux espaces entre deux phrases.
- =Org= -> Org
- J'enlèverais la partie introductive expliquant pourquoi il est utile
de citer le travail d'autrui. Ceci dit, il vaut mieux attendre l'avis
d'autres personnes concernées par la fonctionnalité.
[ Emmanuel Charpentier : I think that this justification may be helpful to a lot of non-scholar org users, who could benefit from org-cite. Advice sollicited... ]
- Je pense qu'il faut éviter de parler ce "citation link", car cela peut
engendrer de la confusion avec "link" qui est une structure proche,
mais différent. Peut-être faut-il parler de "citation object".
- Dans Texinfo, les phrases doivent être séparées par deux espaces.
===========================================
What still lacks :
- an explanation of the four possible functions of an engine ;
- current functionalities of the currently available engines ;
- an org-guide sized summary.
Anyone is welcome to propose modifications. Someone should take the task of collating the propositions and consolidate a final text ; I am reluctant to take this task, given my RL tasks...
Comments, remarks, criticisms, lazzi, etc... all welcome.
--
Emmanuel Charpentier