Refactor: scheduler: best practices for compatible_replica()

Rename to compatible_container(), add a doxygen block, drop unused argument,
and improve variable names, comments, and formatting.

Since the sole caller logs a better message, drop the redundant log here.