More flexible disambiguation

[adam3smith]

As noted in citation-style-language/styles#7667 , disambiguate-add-year-suffix doesn't kick in if the original date differs and is displayed in the citation, making it impossible to generate correct APA style.

There have also been occasional requests to be able to have both short titles added for disambiguation and cross references via first-reference-note-number (e.g. https://forums.zotero.org/discussion/comment/295489/#Comment_295489 ) -- that, too, isn't currently possible with CSL.

I'm not 100% sure how to address this. One idea would be to allow adding ignore-for-disambiguation="true" to any rendering element in cs:citation, but there might be something better.

[denismaier]

One idea would be to allow adding ignore-for-disambiguation="true" to any rendering element in cs:citation, but there might be something better.

Or maybe @ignore-for-disambiguation on cs:citation taking a list of element names? Something like this: ignore-for-disambiguation="title-short publisher whatever"
Then the disambiguation related options would be kept in the same place.

[adam3smith]

That seems both more elegant and likely easier to implement

[denismaier]

Question is just if there might be edge cases where you might want to consider an element for disambiguation in one place, but not in another (doubt it, but anyway).

[bwiernik]

Question is just if there might be edge cases where you might want to consider an element for disambiguation in one place, but not in another (doubt it, but anyway).

I don't think so (at least not common enough to warrant the complexity at least at first).

Would it be easier for style writing and implementation as @use-for-disambiguation?

[bdarcus]

I looked into these two cases a bit for Citum:

As noted in citation-style-language/styles#7667 , disambiguate-add-year-suffix doesn't kick in if the original date differs and is displayed in the citation, making it impossible to generate correct APA style.

This is actually the default behavior in Citum, which I think makes sense from first principles: that one is citing a specific edition.

This might just be a bug in citeproc-js that is so uncommon that it's seldom noticed?

There have also been occasional requests to be able to have both short titles added for disambiguation and cross references via first-reference-note-number (e.g. https://forums.zotero.org/discussion/comment/295489/#Comment_295489 ) -- that, too, isn't currently possible with CSL.

This case required code changes; but again, it's implemented as default behavior now. While I don't much like the rule (because one has to flip back to the first note to know what you're looking at), it does make sense.

The disambiguation strategy in Citum, with caveats and room for future changes, is described in this spec:

https://github.com/citum/citum-core/blob/main/docs/specs/DISAMBIGUATION.md