Did you have a chance to review?

I’ll try to review this weekend

Could you please give me an example how it affect the documentation. With and without this change.

Sure

• Take any godoc
• add a godoc link, so something like [fmt.Stringer]
• generate documentation

You can think about more complex link, even in the current package.

For example, in your package you can add something like called by [NewPackage]

More information here

https://golang.org/doc/comment#doclinks

About the rendering

Take a look here

https://cs.opensource.google/go/go/+/refs/tags/go1.23.4:src/encoding/json/encode.go;l=36

You will see the godoc links in the godoc of Marshal

And here you can see the rendering
https://pkg.go.dev/encoding/json#Marshal

Everything I underlined in yellow are the rendered godoc links

I see the problem, agree, this feature is needed but not sure in the implementation. Need some time to rethink.