1
0
mirror of https://github.com/golang/go synced 2024-11-26 14:08:37 -07:00
go/doc
Giovanni Bajo a3d8326993 doc: first version of new contribute guide
I've reorganized the guide and rewritten large sections.

The structure is now more clear and logical, and can
be understood and navigated using the summary displayed at
the top of the page (before, the summary was confusing because
the guide contained H1s that were being ignored by the summary).

Both the initial onboarding process and the Gerrit
change submission process have been reworked to
include a concise checklist of steps that can be
read and understood in a few seconds, for people
that don't want or need to bother with details.
More in-depth descriptions have been moved into
separate sections, one per each checklist step.
This is by far the biggest improvement, as the previous
approach of having to read several pages just to understand
the requires steps was very scaring for beginners, in
addition of being harder to navigate.

GitHub pull requests have been integrated as a different
way to submit a change, suggested for first time contributors.

The review process has been described in more details,
documenting the workflow and the used conventions.

Most miscellanea have been moved into an "advanced
topics" chapter.

Paragraphs describing how to use git have been removed
to simplify reading. This guide should focus on Go contribution,
and not help users getting familiar with git, for which many
guides are available.

Change-Id: I6f4b76583c9878b230ba1d0225745a1708fad2e8
Reviewed-on: https://go-review.googlesource.com/93495
Reviewed-by: Rob Pike <r@golang.org>
2018-03-22 10:24:44 +00:00
..
articles doc/articles/wiki: highlight the use of _ warning 2018-02-14 04:54:37 +00:00
codewalk
devel all: remove "the" duplications 2018-02-18 17:54:20 +00:00
gopher
play
progs net/http,doc: use HTTP status code constants where applicable 2018-02-26 05:04:31 +00:00
asm.html doc: s/tool chain/toolchain/ 2018-01-09 21:47:03 +00:00
cmd.html
code.html
conduct.html doc: remove Sarah Adams from conduct working group contacts 2018-01-25 17:27:24 +00:00
contrib.html doc/contrib.html: fix outdated link 2017-12-11 22:15:38 +00:00
contribute.html doc: first version of new contribute guide 2018-03-22 10:24:44 +00:00
debugging_with_gdb.html doc: remove interior <code> spaces in debugging, diagnostics docs 2018-01-09 21:48:03 +00:00
diagnostics.html all: restore changes from faulty merge/revert 2018-02-12 20:13:59 +00:00
docs.html doc: fix a sentence position. 2017-11-25 17:06:50 +00:00
editors.html doc/editors: remove feature matrix for various editors/IDEs 2018-02-05 18:37:02 +00:00
effective_go.html doc: fix typo in Effective Go: s/ReaderWriter/ReadWriter/ 2017-11-23 04:07:39 +00:00
gccgo_contribute.html
gccgo_install.html
go1.1.html doc: s/tool chain/toolchain/ 2018-01-09 21:47:03 +00:00
go1.2.html doc: s/tool chain/toolchain/ 2018-01-09 21:47:03 +00:00
go1.3.html doc: s/tool chain/toolchain/ 2018-01-09 21:47:03 +00:00
go1.4.html
go1.5.html
go1.6.html
go1.7.html
go1.8.html
go1.9.html
go1.10.html doc: add note about invalid flag errors to 1.10 release notes 2018-02-16 00:27:49 +00:00
go1.html doc: change anchor URLs from golang.org/dl/ to /dl/ 2018-01-20 04:13:12 +00:00
go1compat.html doc: s/tool chain/toolchain/ 2018-01-09 21:47:03 +00:00
go_faq.html doc/faq: add a Q&A about virus scanners 2018-02-28 05:55:31 +00:00
go_mem.html
go_spec.html Revert "doc: remove non-prime from list of primes in spec" 2018-03-19 21:51:23 +00:00
go-logo-black.png
go-logo-blue.png
go-logo-white.png
help.html
ie.css
install-source.html doc: add GOMIPS to source installation docs 2018-01-30 19:54:01 +00:00
install.html doc: change anchor URLs from golang.org/dl/ to /dl/ 2018-01-20 04:13:12 +00:00
root.html doc: change anchor URLs from golang.org/dl/ to /dl/ 2018-01-20 04:13:12 +00:00
security.html
share.png
tos.html