ImperialCollegeLondon / virtual_ecosystem

This repository is the home for the codebase for the Virtual Ecosystem project.
https://virtual-ecosystem.readthedocs.io
BSD 3-Clause "New" or "Revised" License
8 stars 1 forks source link

Glossary terms for abbreviations in documentation #479

Open jacobcook1995 opened 2 weeks ago

jacobcook1995 commented 2 weeks ago

Is your feature request related to a problem? Please describe. The soil model (and I'm guessing the other models) uses a lot of acronyms, e.g. MAOM for mineral associated organic matter. Having to write out these acronyms every time in docstrings/documentation is tedious, but just writing out the acronyms leads to fairly unreadable documentation.

Describe the solution you'd like The sphinx extension hoverxref allows us to define a glossary which is then used to generate tooltips explaining terms (and in this case acronyms). I will look into this for the soil model as it is pretty acronym heavy