Clicking on a citation takes the reader out the current context, as it generally links to the References page of the project. Even though the browser's back button will return the location of the citation, it can still be disorienting.
A nicer experience would be to show the full reference when hovering over the citation. A similar feature for footnotes was requested in JuliaDocs/Documenter.jl#2080.
As mentioned there, this feature may be possible to implement with pure CSS, or it might require some javascript. And example for javascript that implements something like this would be https://www.jqueryscript.net/text/Inline-Footnotes-On-Hover.html (demo).
Adding javascript functionality to DocumenterCitations would raise the question on how a user would set this up. We already have instructions for manually adding CSS. Adding .js files to that (especially if they're required for the plugin to function properly) might be a bit too much. It would be good have have capabilities in Documenter to enable plugins to inject custom css/js, see JuliaDocs/Documenter.jl#1612.
On the other hand, if JuliaDocs/Documenter.jl#2080 was implemented first, that might allow DocumenterCitations to just reuse that implementation.
Clicking on a citation takes the reader out the current context, as it generally links to the References page of the project. Even though the browser's back button will return the location of the citation, it can still be disorienting.
A nicer experience would be to show the full reference when hovering over the citation. A similar feature for footnotes was requested in JuliaDocs/Documenter.jl#2080.
As mentioned there, this feature may be possible to implement with pure CSS, or it might require some javascript. And example for javascript that implements something like this would be https://www.jqueryscript.net/text/Inline-Footnotes-On-Hover.html (demo).
Adding javascript functionality to DocumenterCitations would raise the question on how a user would set this up. We already have instructions for manually adding CSS. Adding
.jsfiles to that (especially if they're required for the plugin to function properly) might be a bit too much. It would be good have have capabilities in Documenter to enable plugins to inject custom css/js, see JuliaDocs/Documenter.jl#1612.On the other hand, if JuliaDocs/Documenter.jl#2080 was implemented first, that might allow DocumenterCitations to just reuse that implementation.