271828…
"When I get a Mathcad sheet from a colleague, I usually have trouble following it. An equation on the fifth page will use variables that are defined on earlier pages. I go back to the second page and find where the variable is defined. However, it might be redefined on the third page. Many variable names are used repeatedly, like d, L, A, etc."
I mostly agree with your criticisms, but they should be directed at your colleagues and not at Mathcad. Whether it's Excel or Mathcad, some (many?) users seem incapable of creating easily-usable and easily-understandable documents. It takes additional thought and effort, but it's not too difficult to apply good organization, good formatting (including paying attention to how the document will look when printed), good documentation, etc. The math and calculation logic may or may not be difficult and it's up to the user to understand if it's beyond their capabilities or not. Unfortunately, not every user has the requisite level of self-awareness.
I have seen excellent Excel and Mathcad documents from others and I have seen terrible ones. Most I see are somewhere in between. For example, years ago I received an Excel spreadsheet from a colleague. The purpose of the spreadsheet was to estimate future water demands in various communities served by an extensive rural water system. The math and logic wasn't too difficult. However, among various errors, my colleague had entered every negative number as text (some areas were forecast to reduce water usage) and most of his summation ranges didn't match the extent of the data, etc. Interestingly, after correcting all of his errors, I discovered that his totals weren't too far off what they should have been. Thank goodness for compensating errors.
I have no colleagues at the moment who use Mathcad, but every so often I receive a Mathcad document as part of a contractor's submittal, including structural calculations for buried precast concrete vaults, for a set of chemical storage tanks, for polyethylene water storage tanks, etc.. I will politely say that my review of said documents almost always includes a certain amount of training for the vendor's engineer. These engineers routinely do what you object to, including reusing variable names, and some things you didn't mention such as redefining the same variable at the top of each page (instead of just letting its previous definition carry through), mixing the units lb, lbm, and lbf and getting nonsensical results (why didn't they catch it before it went out?), adding incorrect units to empirical equations, etc. In two cases, I actually called the vendor's engineer to discuss with them how to better use Mathcad. Both engineers were very young and I think they appreciated my help With one of these engineers, the next submittal I received from them about a year later was MUCH improved.
BTW, the solution to avoiding redefined variables is to use subscripts, such as d
1, d
A, etc.
============
"Is it the only lesson of history that mankind is unteachable?"
--Winston S. Churchill