There are solutions to this like having a doc comment right next to the function which is picked up by some API generator. Then it’s easier to keep in sync. That can work well even in languages without explicit parameter types.

Of course it won’t help LLMs as much, but I personally don’t mind that.