Links to source code of methods on protobuf types are broken

[beccasaurus]

Example: docs for Google::Monitoring::V3::TimeInterval

^--- Source Code link broken

Broken link: https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/google-cloud/master/google-cloud-monitoring/lib/google/cloud/monitoring/v3/doc/google/monitoring/v3/common.rb#L49

Or all of the Source Code links on google/api types like: Google::Api::Metric or common types like Google::Protobuf::Timestamp

[blowmage]

The correct link is:

https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/google-cloud-monitoring/lib/google/cloud/monitoring/v3/doc/google/monitoring/v3/common.rb#L49

[blowmage]

Unfortunately, all those links will be to the dummy documentation files, and not show any code, because so much of these GAPIC methods are created at runtime.

[quartzmo]

This behavior is unfortunately present for all types' source links (not just GAPIC) in the google-cloud meta-package docs.

In google-cloud's Google::Cloud::Bigquery::Project, all source code links return 404, since they link to a path (google-cloud-ruby/blob/google-cloud/master/google-cloud-bigquery/) that does not exist in the meta-package's source directory.

In google-cloud-bigquery's Google::Cloud::Bigquery::Project, the source code links work correctly.

There is probably a one-off workaround for this, but it is yet another example of the difficulty of implementing meta-package docs as copies of member package docs, rather than as simply references to member package docs.

[quartzmo]

Moved to the public planning wiki due to the delay in implementing the new documentation site.