Update git-primer.md cottage14-patch-1 58/head
authorAndrew Wetmore <andrew@cottage14.com>
Tue, 29 Mar 2022 13:15:04 +0000 (10:15 -0300)
committerGitHub <noreply@github.com>
Tue, 29 Mar 2022 13:15:04 +0000 (10:15 -0300)
Changed examples from gitbox to GitHub, as we are emphasizing use of GitHub.

content/pages/git-primer.md

index bb645cb5b639c89e3450926184e68cac607ae71a..f519f45c50bbfb1b94cde3d58df9f10d9f8b2094 100644 (file)
@@ -4,7 +4,7 @@ This document is a primer on using Git for an Apache Software Foundation project
 
 ## Contents ##
 
-  - <a href="#repotypes">Repository types</a>
+  - <a href="#repos">Repositories</a>
   - <a href="repocheckout">Repository checkout</a>
   - <a href="#committers">Committers: getting started</a>
   - <a href="#windowsusers">Windows users</a>
@@ -12,27 +12,24 @@ This document is a primer on using Git for an Apache Software Foundation project
   - <a href="#trouble">Troubleshooting</a>
   - <a href="#further">Further reading</a>
 
-<h2 id="repotypes">Repository types<a class="headerlink" href="#repotypes" title="Permanent link">&para;</a></h2>
+<h2 id="repos">Apache git repositories<a class="headerlink" href="#repos" title="Permanent link">&para;</a></h2>
 
-There are two forms of Git repositories:
+This page is about Apache read/write repositories hosted at `http://github.com/apache/`.
 
-1. Read-only mirrors hosted at `https://git.apache.org`
-2. Read/write repositories hosted at `https://gitbox.apache.org/repos/asf`
-
-This document is chiefly about the read/write repositories.
+Access a repository through <a href="https://github.com/apache/" target="_blank">GitHub</a>. If you have concerns about GitHub's terms and conditions, use Apache's <a href="https://gitbox.apache.org/" target="_blank">gitbox</a>, which also gives full access to Apache's writable Git repositories. 
 
 <h2 id="repocheckout">Repository checkout<a class="headerlink" href="#repocheckout" title="Permanent link">&para;</a></h2>
 
 The repository URLs are all of the form:
 
 ```
-https://gitbox.apache.org/repos/asf/reponame.git
+https://github.apache.org/repos/asf/reponame.git
 ```
 
 ### Cloning a repository ###
 
-  - **Committers**: `$ git clone https://gitbox.apache.org/repos/asf/reponame.git`
-  - **Non-Committers**: `$ git clone http://gitbox.apache.org/repos/asf/reponame.git`
+  - **Committers**: `$ git clone https://github.apache.org/repos/asf/reponame.git`
+  - **Non-Committers**: `$ git clone http://github.apache.org/repos/asf/reponame.git`
 
 <h2 id="committers">Committers: getting started<a class="headerlink" href="#committers" title="Permanent link">&para;</a></h2>
 
@@ -64,7 +61,7 @@ If you do not see an authentication prompt, you need to set up a `~/.netrc` file
 
 ```
 $ (umask 0277; cat >> ~/.netrc <<EOF)
-machine gitbox.apache.org
+machine github.apache.org
 login username
 password mypassword
 EOF
@@ -74,7 +71,7 @@ chmod 0600 ~/.netrc
 You can list your user name in the Git repository URL, but this requires that you provide your password for every fetch and push. You can simplify this step by cloning a URL like:
 
 ```
-$ git clone https://username@gitbox.apache.org/repos/asf/reponame.git
+$ git clone https://username@github.apache.org/repos/asf/reponame.git
 ```
 
 While it's _possible_ to list your password in the URL, we discourage this practice as it leaves your password in plain text in the shell history.
@@ -86,7 +83,7 @@ You can use `git-gui` as part of the `msysgit` package.
 Instead of setting up a `~/.netrc` file you need to:
 
 1. Set up a `%HOME%` environment pointing to `C:\Users\yourloginname\`
-1. Create a `_netrc` file in `%HOME%_netrc` with this text all on one line: `machine gitbox.apache.org login username password mypassword`
+1. Create a `_netrc` file in `%HOME%_netrc` with this text all on one line: `machine github.apache.org login username password mypassword`
 
 <h2 id="lineendings">Line endings<a class="headerlink" href="#lineendings" title="Permanent link">&para;</a></h2>
 
@@ -104,14 +101,14 @@ Further details and attributes for handling line endings differently per file ty
 If you get an error like this:
 
 ```
-error: no DAV locking support on http://gitbox.apache.org/repos/asf/reponame.git/
+error: no DAV locking support on http://github.apache.org/repos/asf/reponame.git/
 fatal: git-http-push failed
 ```
 
 It means that you're trying to push over **HTTP**, which is disabled. To fix this error change the remote repository URL to use **HTTPS**. You can edit the `.git/config` file to update the URL variable, or use:
 
 ```
-$ git config remote.origin.url https://gitbox.apache.org/repos/asf/reponame.git
+$ git config remote.origin.url https://github.apache.org/repos/asf/reponame.git
 ```
 
 <h2 id="further">Further reading<a class="headerlink" href="#further" title="Permanent link">&para;</a></h2>