Can't view documentation

[mx-psi]

Describe the bug

I can't view the documentation on https://pkg.go.dev/github.com/DataDog/datadog-api-client-go/[email protected]/api/datadogV2

To Reproduce Steps to reproduce the behavior:

1. Go to https://pkg.go.dev/github.com/DataDog/datadog-api-client-go/[email protected]/api/datadogV2
2. You can see an error message saying 'Documentation is too large to display.'

Expected behavior

I can read the documentation :)

Screenshots

[therve]

Hi,

It's a limitation of pkg.go.dev that I don't think we can do much about. We do have a working version at https://datadoghq.dev/datadog-api-client-go/pkg/github.com/DataDog/datadog-api-client-go/v2/api/datadogV2/ though. Does that work for you? Thanks.

[mx-psi]

It's a limitation of pkg.go.dev that I don't think we can do much about.

Splitting into multiple packages would definitely help, but that would be for the next major version I guess

We do have a working version at https://datadoghq.dev/datadog-api-client-go/pkg/github.com/DataDog/datadog-api-client-go/v2/api/datadogV2/ though. Does that work for you? Thanks.

It does! Would be great if that were linked directly on the package page. I think you can do this as described on golang/go/issues/42968, see example on https://pkg.go.dev/github.com/jba/links. That way this will show on the right under the 'Links' header.

[github-actions[bot]]

Thanks for your contribution!

This issue has been automatically marked as stale because it has not had activity in the last 30 days. Note that the issue will not be automatically closed, but this notification will remind us to investigate why there's been inactivity. Thank you for participating in the Datadog open source community.

If you would like this issue to remain open:

1. Verify that you can still reproduce the issue in the latest version of this project.

2. Comment that the issue is still reproducible and include updated details requested in the issue template.

[ghost]

OK... so aside the oddity of the humongous package that breaks pkg.go.dev... the other ad-hoc documentation link https://datadoghq.dev/datadog-api-client-go/pkg/github.com/DataDog/datadog-api-client-go/v2/api/datadogV2/ is also broken now: so... no docs at all :disappointed:

[therve]

This is back, sorry for the inconvenience.

[github-actions[bot]]

Thanks for your contribution!

This issue has been automatically marked as stale because it has not had activity in the last 30 days. Note that the issue will not be automatically closed, but this notification will remind us to investigate why there's been inactivity. Thank you for participating in the Datadog open source community.

If you would like this issue to remain open:

1. Verify that you can still reproduce the issue in the latest version of this project.

2. Comment that the issue is still reproducible and include updated details requested in the issue template.

[ghost]

Ping. IMHO this humongous package could / should be broken down into more modest size packages. Even when viewing things on GH pages, the page is so huge, that my browser freezes for 1-2s on every click. Pretty bad.

[tonglil]

+100 on this, it makes finding any information a huge pain that I just revert to using the http endpoints because of the difficulty in simply opening the docs to find which functions to call.