The go-code.md file is mostly redundant relative to
contributors/devel/development.md and godep.md, the
contributors/guide/coding-conventions.md document and the various
now standard and easily searchable k8s external sources of information
about the Go language.
The redundant links are simply dropped.
The moovweg/gvm link is dropped as the project appears stale with no
releases in years, many open issues, no commits in a year and shows a build
failure in its CI badge.
The emptied go-code.md file is retained, leaving a pointer to the
new location in its place.
Signed-off-by: Tim Pepper <tpepper@vmware.com>
The coding-conventions document covers useful introductory guidance for
all. This commit moves it out of the devel/ detail directory and into the
contributor/guide, fixing up links from other doc's in this repo and
leaving a cookie crumb of a document pointing at the new location.
Signed-off-by: Tim Pepper <tpepper@vmware.com>
The usage of 'godep' is covered in detail in the godep.md. And forked
golang appears to have moved directories.
Signed-off-by: Tim Pepper <tpepper@vmware.com>
The coding advice section had only one bullet, which is golang specific, so
bump that up into the Go section as a sub-bullet.
Signed-off-by: Tim Pepper <tpepper@vmware.com>
The difference between the two links for communications around questions
and troubleshooting was not clear to me, and the wording made them
seem somewhat redundant. They're really two separate topic links,
so I've changed the wording to hopefully make it more clear that one has
general communications information and once is actually a
troubleshooting guide.
Signed-off-by: Tim Pepper <tpepper@vmware.com>
- spell out no_parent_owners use case a bit more
- call out that parts of the process are configurable per-repo
- wordsmith reviewer/approver choices to explicitly call out who can
act as each role
- spell out approve plugin configuration
- spell out tide configuration (elide over queries, pretend like it's
entirely repo-centric)
- spell out that tide will rerun presubmit jobs if there are any
configured
- encourage people