Bidirectional mapping documentation

[jassielof]

I'm trying to add Hayagriva to BibLaTeX conversion, but I'm wondering if there is a better documentation, other than the code, to understand the mapping that is done from bib to Hayagriva.

Also if the conversion process should follow conditionals depending on the type of the entry, considering that BibLaTeX has required and optional fields per entry.

[PgBiel]

There isn't written documentation on this. In principle, the documentation is the code, so any written docs would have to stay in sync with the code. But that can be done I think.

[jassielof]

Hmm yeah, syncing but changing the mapping is really little isn't it? Or at least I don't think the mapping from any bib to Hayagriva has been changed? I'll just try to well post the mapping table either here or in the other issue at least to let you know if it looks fine before continuing even more I guess then.

At least it also feels is more transparent for revisions, as I feel the conversion is somewhat lossy and buggy, which the docs would help to have a reference static point on how should the conversion happen. Specially considering that Hayagriva is dealing with not only BibLaTeX but BibTeX, which is much more limited.

And I think it would be also worth mentioning against what BibLaTeX version Hayagriva is dealing with, even though it doesn't tend to change drastically.

As for plain BibTeX, its documentation is well, lacking (I think)

[daeh]

Note that there are some issues/bugs in the current BibLaTeX-Hayagriva mapping, e.g. #437