开发人员手册(持续更新中)
<p>相比社区版本,GitHub企业版作为GitHub的商用版本提供了更多的功能:私有库支持分支保护、Pages and wikis、存储库透视(Repository insights);产品全面支持组织和团队管理、双因素身份认证、审计日志、SAML单点登录、预接收挂钩等功能。</p>
<p> </p>
<p><span style="font-size:16px"><strong>代码协作工作流</strong></span></p>
<p><span style="font-size:16px"><strong>第1步 创建存储库</strong></span></p>
<p>一个库通常用于举办单个项目。存储库可以包含文件夹和文件,图像,视频,电子表格和数据集 - 您的项目需要的任何内容。我们建议包括README或包含项目信息的文件。GitHub可以在创建新存储库的同时轻松添加一个。它还提供其他常见选项,例如许可证文件。</p>
<p>您的hello-world存储库可以是存储想法,资源甚至与他人共享和讨论事物的地方。</p>
<p><strong>创建新存储库</strong></p>
<p>1. 在右上角,在您的头像或identicon旁边,单击<strong>+, </strong>然后选择New repository。</p>
<p>2. 命名您的存储库hello-world。</p>
<p>3. 写一个简短的描述。</p>
<p>4. 选择使用自述文件初始化此存储库。</p>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410145912-1d8b59749c0a.png" /></p>
<p>5. 单击<strong>创建存储库</strong>。</p>
<p> </p>
<p><span style="font-size:16px"><strong>第2步 创建一个分支</strong></span></p>
<p>分支是一次处理不同版本的存储库的方法。默认情况下,您的存储库有一个名为branch的分支master,该分支被认为是权威分支。我们使用分支进行实验并在提交之前进行编辑master。</p>
<p>当您在分支机构上创建分支时master,您正在制作该master时间点的副本或快照。如果其他人master在您的分支机构上工作时对分支进行了更改,则可以提取这些更新。</p>
<p>该图显示:</p>
<ul>
<li>该master分支</li>
<li>一个叫做的新分支feature(因为我们在这个分支上做'特色工作')</li>
<li>feature它融入之前的旅程master</li>
</ul>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410150046-189b32999086.png" /></p>
<p>你有没有保存过不同版本的文件?就像是:</p>
<ul>
<li>story.txt</li>
<li>story-joe-edit.txt</li>
<li>story-joe-edit-reviewed.txt</li>
</ul>
<p>分支机构在GitHub存储库中实现了类似的目标。</p>
<p>在GitHub,我们的开发人员,编写人员和设计人员使用分支来保持错误修复和功能工作与我们的master(生产)分支分开。当更改准备就绪时,他们将其分支合并到master。</p>
<p><strong>创建一个新分支</strong></p>
<p>1. 转到新的存储库hello-world。</p>
<p>2. 单击文件列表顶部的下拉列表:master:master。</p>
<p>3. readme-edits在新分支文本框中键入分支名称。</p>
<p>4. 选择蓝色的创建分支框或按键盘上的“Enter”。</p>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410151930-185d405f990e.png" /></p>
<p>现在你有两个分支,master和readme-edits。它们看起来完全一样,但不会很久!接下来,我们将更改添加到新分支。</p>
<p> </p>
<p><span style="font-size:16px"><strong>第3步 制作并提交更改</strong></span></p>
<p>好样的!现在,您在readme-edits分支的代码视图中,这是一个副本master。我们来做一些编辑。</p>
<p>在GitHub上,保存的更改称为提交。每个提交都有一个关联的提交消息,这是一个解释为什么进行特定更改的描述。提交消息可捕获更改的历史记录,因此其他贡献者可以了解您已完成的操作以及原因。</p>
<p><strong>制作并提交更改</strong></p>
<p>1. 单击该README.md文件。</p>
<p>2. 点击 要编辑的文件视图右上角的铅笔图标。</p>
<p>3. 在编辑器中,写一点关于你自己。</p>
<p>4. 编写描述更改的提交消息。</p>
<p>5. 单击提交更改按钮。</p>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410150316-1714c49596f3.png" /></p>
<p>这些更改将仅对readme-edits分支上的README文件进行,因此现在此分支包含的内容与之不同master。</p>
<p> </p>
<p><span style="font-size:16px"><strong>第4步 打开Pull请求</strong></span></p>
<p>现在您的分支中有更改master,您可以打开拉取请求。</p>
<p>Pull Requests是GitHub上合作的核心。当您打开拉取请求时,您提出了更改并请求某人审核并提取您的贡献并将其合并到他们的分支中。拉请求显示来自两个分支的内容的差异或差异。更改,添加和减少以绿色和红色显示。</p>
<p>提交后,即使在代码完成之前,您也可以打开拉取请求并开始讨论。</p>
<p>通过在拉取请求消息中使用GitHub的@mention系统,您可以询问特定人员或团队的反馈,无论他们是在大厅还是10个时区之外。</p>
<p>您甚至可以在自己的存储库中打开pull请求并自行合并。在开展大型项目之前,这是学习GitHub流程的好方法。</p>
<p><strong>打开Pull Request以更改README</strong></p>
<p>单击图像查看大图</p>
<table border="0" cellpadding="0" cellspacing="0">
<thead>
<tr>
<td>
<p>步骤</p>
</td>
<td>
<p>截图</p>
</td>
</tr>
</thead>
<tbody>
<tr>
<td>
<p>单击“<strong>拉取请求</strong>”选项卡,然后从“拉取请求”页面中,单击绿色<strong>“ 新拉”请求</strong>按钮。</p>
</td>
<td>
<p><a href="http://guides.github.com/activities/hello-world/pr-tab.gif">查看动图</a></p>
</td>
</tr>
<tr>
<td>
<p>在“ <strong>示例比较</strong>”框中,选择您创建的分支readme-edits,以与master(原始)进行比较。</p>
</td>
<td>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410151712-122663559c24.png" /></p>
</td>
</tr>
<tr>
<td>
<p>在比较页面上查看差异中的更改,确保它们是您要提交的内容。</p>
</td>
<td><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410151652-130320de9af8.png" /></td>
</tr>
<tr>
<td>
<p>如果您对要提交的更改感到满意,请单击绿色的<strong>“创建拉取请求”</strong>按钮。</p>
</td>
<td>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410151632-126d2ed8961c.png" /></p>
</td>
</tr>
<tr>
<td>
<p>为您的拉取请求提供标题,并写下您的更改的简要说明。</p>
</td>
<td>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410151303-11ee6f879a78.png" /></p>
</td>
</tr>
</tbody>
</table>
<p>完成邮件后,单击“<strong> </strong><strong>创建拉取请求”</strong>!</p>
<p>提示:您可以使用表情符号及将图片和GIF拖放和引入到意见与拉取请求中。</p>
<p> </p>
<p><span style="font-size:16px"><strong>第5步 合并您的Pull请求</strong></span></p>
<p>在最后一步中,是时候将您的更改结合在一起 - 将您的readme-edits分支合并到master分支中。</p>
<p>1. 单击绿色<strong>合并拉取请求</strong>按钮以将更改合并到master。</p>
<p>2. 单击<strong>确认合并</strong>。</p>
<p>3. 继续删除分支,因为它的更改已合并,紫色框中的<strong>删除分支</strong>按钮。</p>
<p><img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181410150535-1e57b16792de.png" /></p>
<p> <img src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20181910202949-18767e699981.png" style="height:75px; width:646px" /></p>
提交成功!非常感谢您的反馈,我们会继续努力做到更好!