Yeah, it should probably be more "your technical documentation should have a consistent tone" I appreciate light-hearted asides in documentation. But more if

Yeah, it should probably be more "your technical documentation should have a consistent tone" I appreciate light-hearted asides in documentation. But more if I expect it than when it's unexpected. Like you wouldn't want to end up confusing some ESL programmer who goes ask a lawyer whether they should be worried about this? Or if you're really ambitious, make all your docs super funny! But if you mix the tone it's disorienting and maybe bad writing.