docs: small markup and xref fixes