x/website: golang.org/doc/articles/wiki is broken

[kortschak]

The https://golang.org/doc/articles/wiki/ page linked from https://golang.org/doc/#articles is broken presumably due to the content being moved out to x/website in 0cb3415.

[ianlancetaylor]

CC @rsc @dmitshur

[dmitshur]

The problem is because the wiki directory in x/website contains a file named "go.mod":

https://github.com/golang/website/blob/master/_content/doc/articles/wiki/go.mod

Despite being inside a _content directory that the go tool largely ignores due to the "_" prefix, it isn't ignored for the purpose of carving out a nested module. The content of that directory is not included in website.Content, because embed.FS doesn't reach beyond its module boundaries.

[gopherbot]

Change https://golang.org/cl/292829 mentions this issue: cmd/golangorg: read _content directory from disk in production

[dmitshur]

I'm not sure what's the best thing to do here. If we continue to use //go:embed, we can't place any files named "go.mod" in _content. Maybe we shouldn't do that regardless.

I've sent CL 292829 with a workaround of reading files from disk (as was done to some extent before CL 291690). We can consider using that approach to fix the immediate problem on golang.org and buy more time to think about a long term fix here. It's functional as of patch set 2, and can be previewed here.

@rsc Let me know how you'd like to proceed here.

[gopherbot]

Change https://golang.org/cl/293410 mentions this issue: _content/doc/articles/wiki: delete go.mod

[rsc]

I don't think the go.mod is doing anything useful. Sent CL 293410 to delete it.