EDU 1942: Improve Pub/Sub Java Readme (#1088)

This PR streamlines and refocuses the content of README.md to improve
readability, simplify navigation, and make ongoing maintenance easier.

Author: franrob-projects