The conversion to //go:build constraints was Go proposal 41184, which stated:

I propose that we adopt this design, with N = 17 in the Transition section, meaning that the prep work would happen in Go 1.16, the main change would land in Go 1.17, and the transition would be finalized in Go 1.18.

Does it work to start with the proposal first, which should have the information you're describing? Or do you still think design draft documents should be updated if they're used in a Go proposal? (If so, it seems this itself can be a proposal to establish that property.)

@dmitshur I don't think we need to approve a proposal to update design docs. They are just documentation. A doc like https://go.dev/design/draft-gobuild should be updated to link to the proposal issue. Anybody can do that.

The conversion to //go:build constraints was Go proposal 41184, which stated:

I propose that we adopt this design, with N = 17 in the Transition section, meaning that the prep work would happen in Go 1.16, the main change would land in Go 1.17, and the transition would be finalized in Go 1.18.

Does it work to start with the proposal first, which should have the information you're describing? Or do you still think design draft documents should be updated if they're used in a Go proposal? (If so, it seems this itself can be a proposal to establish that property.)

Since a proposal is not always linked to a github issue, I think it is worth having common metadata in the document header.
This is useful both for historical reasons and for documentation (one example is the type-parameters proposal).

Thanks.

I want to clarify that a proposal is always linked to a GitHub issue. However, in some cases design drafts were written and published before the GitHub issue was created, and nobody went back to add a link.

If you have a specific suggestion for a metadata format, then I suppose that that should go through the proposal process as @dmitshur suggests. But I personally don't think it's necessary.

Timed out in state WaitingForInfo. Closing.

(I am just a bot, though. Please speak up if this is a mistake or you have the requested information.)