[wp-meta] [Making WordPress.org] #1103: Add WordPress Git & GitHub mirror docs to https://wordpress.org/download/

[Making WordPress.org]

#1103: Add WordPress Git & GitHub mirror docs to https://wordpress.org/download/
--------------------------+----------------------------------------
  Reporter:  netweb       |      Owner:  iandunn
      Type:  enhancement  |     Status:  assigned
  Priority:  normal       |  Component:  General
Resolution:               |   Keywords:  needs-patch good-first-bug
--------------------------+----------------------------------------

Comment (by iandunn):

 Maybe something like `/download/svn-git` would be more better? It'd be
 more specific and familiar than "VCS"; I'd worry that a lot of newer devs
 wouldn't recognize "VCS."

 My first instinct would be to have separate sections for SVN and Git,
 rather than mixing the two. That way visitors could focus only on the
 parts that are relevant to them, and ignore the rest. That'd be quicker to
 scan, and would avoid people being confused about which commands to use.

 It'd also give us a better opportunity to highlight the differences
 between the two workflows. With Git it's important to stress the need to
 work on separate branches for separate tickets, generate patches with
 `--no-prefix`, etc.

 Although, that makes me wonder if the page should even be discussing how
 to generate patches and whatnot. It is a "download" page after all, not a
 "contribute" page. Now that we have the Core Handbook, I think it might be
 better to just have an intro about the history of WP's VCS usage, and show
 very brief info of how to check out/clone trunk, then link to the Core
 Handbook for details on a full contributing workflow.

 The Handbook would need a Git equivalent to
 [https://make.wordpress.org/core/handbook/svn/ the SVN page] first,
 though, which would be really nice to have anyway. It could borrow some
 info from [https://make.wordpress.org/meta/handbook/documentation
 /contributing-with-git/ the Git page in the Meta handbook], but will have
 some significant differences because we have an actual Git repo for Core,
 rather than needing to use ''git-svn''.

 Thoughts on all that, everyone?

--
Ticket URL: <https://meta.trac.wordpress.org/ticket/1103#comment:6>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org