@dalias @lauren All modern documentation has only two modes,
"To implement a custom CFD solver, remember that Frob frobbles frobbables using the Omega Mu bistatic convention adopted by Klorzen [87]"
And
"The computer had a whoopsie, so try again later or ask someone for help."
There is no middle ground, and all the technical writers got fired 30 years ago so it's all written by devs who know too much or interns who know nothing."