Closed proycon closed 5 years ago
So what is the difference between this annotation and the Reference annotation? They smell a bit the same.
Reference is a a structure annotation element that is an explicit reference in the text, think of things like footnotes and hyperlinks. This is higher-order annotation that can set a relationship between anything.
But yes, the terminology might be confusing. This could just as well have been called reference in another parallel universe.
and the one off the reference examples seems (almost) to do what relation does.
<note xml:id="example.note.1" class="footnote">
<part>
<t>See our website.</t>
</part>
<ref xml:id="example.ref.2" xlink:href="https://github.io/folia" xlink:type="simple" format="text/html" />
</note>
So this has to be explained carefully. And I fear that users also will loose track.
Yes, the documentation has been reworked so it should be clear hopefully. Feel free to judge for yourself: https://folia.readthedocs.io/en/folia2.0/reference_annotation.html
is surely much clearer
I'm contemplating renaming alignment annotation (see https://folia.readthedocs.io/en/folia2.0/alignment_annotation.html, a form of higher-order annotation) to relation annotation, which sounds more generic and far more to the point.
It would require some extra hacks for backward compatibility with the old name.