Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Currently, seven Decapodes docs pages cite scientific works. Since our docs our written in markdown, it is easy to put quickly add a link and get on with writing. Writing a references block is achieved by generating a bibliography in plain text and pasting it into markdown directly.
However, we can run into consistency errors if we remove a link but forget to also remove its bibliography entry. Further, some docs reference the same set of works, and besides repeated effort, we can run into issues if canonical links are not used for the same work. Another manual burden is collating references used across each docs page into a single references page. The manual aspect of managing bibliographies reduces the quality and scientific merit of our docs pages.
Using bibtex is the standard way to resolve this issue for scientific documentation.
So, we should centrally manage our references with bibtex via the DocumenterCitations.jl package.