Cleanup batching documentation for the Publisher

[suzmue]

The batching settings doc comments don't follow the rust conventions. See https://github.com/googleapis/google-cloud-rust/pull/4343/changes#r2723077253

See for more style info: https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html#documenting-components