News for hackers. Stuff that matters.
Re:What I learned in 2017 writing Go by lobster_johnson on Wednesday January 03, 2018 @05:38PM (#16066036)
Some projects dump everything in the root of the repo. I find that to be annoyingly messy.

Comingling non-Go dirs with Go code makes it hard to navigate, since some dirs will be Go packages, and some won't. You may want to have documentation (/docs, perhaps), test data (/test?), build output dirs (/build or /dist), Docker/Kubernetes/Helm dirs (/docker, /k8s, etc.), Protobuf files (/proto), and so on, usually all in the root of the project.

Secondly, these directories might conflict with Go package names. We have a project that has a package called "documents", which is about persistent documents, which we'd have preferred to call "docs", but the root already had a /docs folder for actual documentation.

Personally, I prefer "src".

Re:What I learned in 2017 writing Go by frou_dh on Thursday January 04, 2018 @03:15PM (#16073670)
Good points.

More fundamentally, it feels a bit screwy for a multi-faceted 'project' to live wholly inside $GOPATH in the first place. But at the same time, it's natural.