Fix broken links in the generated rst documentation

[ohmayr]

Update rst.py file in the generator and ensure that the generated rst documentation does not have broken links. Also validate that the links work on cloud.google.com.

• Correctly transform [Text] (URL) and fix broken [Text][Ref] patterns into valid RST hyper-links