x/exp/cmd/gorelease: add more documentation for version

Version and release are a bit confusing: naively, they seem like the same thing.
Version also doesn't have a lot of documentation around it.

I tend to forget what version is used for, and have many times spent time
re-remembering. So, I figured I'd write it down for future developers.

Change-Id: Ic649d5625032bf2cb2f98a294f9689ef2d8e1d5e
Reviewed-on: https://go-review.googlesource.com/c/exp/+/304149
Trust: Jean de Klerk <deklerk@google.com>
Run-TryBot: Jean de Klerk <deklerk@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Jay Conrod <jayconrod@google.com>
1 file changed
tree: bc1540404488161f2c726e0a8dc194a212dc1691
  1. .gitattributes
  2. .gitignore
  3. AUTHORS
  4. CONTRIBUTING.md
  5. CONTRIBUTORS
  6. LICENSE
  7. PATENTS
  8. README.md
  9. apidiff/
  10. cmd/
  11. codereview.cfg
  12. ebnf/
  13. ebnflint/
  14. errors/
  15. fsnotify/
  16. go.mod
  17. go.sum
  18. inotify/
  19. io/
  20. mmap/
  21. rand/
  22. shiny/
  23. shootout/
  24. sumdb/
  25. utf8string/
  26. winfsnotify/
README.md

exp

PkgGoDev

This subrepository holds experimental and deprecated (in the old directory) packages.

The idea for this subrepository originated as the pkg/exp directory of the main repository, but its presence there made it unavailable to users of the binary downloads of the Go installation. The subrepository has therefore been created to make it possible to go get these packages.

Warning: Packages here are experimental and unreliable. Some may one day be promoted to the main repository or other subrepository, or they may be modified arbitrarily or even disappear altogether.

In short, code in this subrepository is not subject to the Go 1 compatibility promise. (No subrepo is, but the promise is even more likely to be violated by go.exp than the others.)

Caveat emptor.