Is this something we can actually fix (easily)?
Not sure, you can try migrating the guide to AsciiDoc