I took a brief stab at something that's bothered me with https://pkg.go.dev: how poorly promoted examples are in package documentation.

Do you think this is worth proposing in a FR?

The main difference is promoting examples as a top-level index item as opposed to being nested somewhat opaquely in the body on the right. Being embedded remains, but the left-hand navigation bar surfaces examples much more readily.