> TBH, blindly substituting "them" and "they" everywhere will result in sentences that are incorrect

If done blindly, potentially. If done properly, no. Modern tech writing tends to use singular they anyway.

> It doesn't take a huge lack of empathy to suggest that it's better to write in a way that's grammatically correct

Singular they is not incorrect.