20210723

Author: oxygen-dioxide

1.md

@@ -0,0 +1,33 @@
+# 1. Github是什么
+本文将从非程序员的角度简要介绍Github及其提供的主要功能。
+
+如果你在网上搜索“Github是什么”，你应该会得到类似这样的回答
+```
+GitHub是通过Git进行版本控制的软件源代码托管服务平台
+......
+GitHub同时提供付费账户和免费账户。这两种账户都可以创建公开或私有的代码仓库，但付费用户支持更多功能。根据在2009年的Git用户调查，GitHub是最流行的Git访问站点。除了允许个人和组织创建和访问保管中的代码以外，它也提供了一些方便社会化共同软件开发的功能，即一般人口中的社区功能，包括允许用户追踪其他用户、组织、软件库的动态，对软件代码的改动和bug提出评论等。GitHub也提供了图表功能，用于概观显示开发者们怎样在代码库上工作以及软件的开发活跃程度。
+......
+```
+（来自[维基百科](https://zh.wikipedia.org/wiki/GitHub)）
+
+但是，程序员的世界可能离我们有些遥远，我们不知道“Git”、“版本控制”、“源代码托管”是什么，也不需要知道这些。那么如何去理解Github呢？
+
+首先，Github最核心的功能，是**网盘**。
+- 这个网盘里面可以存储文本、图片、视频、音频等一切类型的文件。
+- 每个人可以创建多个网盘，以便分门别类地整理文件。例如，可以给每门课程开一个网盘存放笔记。这样的一个网盘叫做“仓库（repository）”
+- 网盘可以公开（public），也可以私有（private）。
+- 如果你看到了一个好的网盘，你可以在页面右上角给它点赞（Star），关注（Watch），或复制一份到自己的账号下（Fork）
+- Github保存了网盘的所有历史记录，可以快速比较历史版本，或回到某个历史版本（例如不小心删了文件）。
+
+在网盘的基础上，Github提供了强大的**协作**功能，比腾讯、金山等在线文档更强大。
+
+假如你写了一本书找别人修改，他会复制一份到他的账户下进行修改，然后向你发出Pull Request。你可以预览他的编辑。如果同意，就将他的编辑合并回你的仓库。你也可以选择不同意。
+
+与在线文档相比，Github可以避免他的恶意编辑或误操作破坏你的文档。（当然，如果你信任他，你可以把他加入你的仓库，直接编辑你的文件）
+
+你们可能还需要一个地方来**讨论**这本书该怎么写，别人也想对文章的内容做更深入的讨论。Issue就是一个类似BBS的讨论区。
+
+书写完之后，你想知道你的书有没有人看，哪一章最受欢迎。如果是很多人一起写的，你还想知道每个人分别写了多少。Github提供**统计**（Insights）功能。
+
+最后，你将独立的文章整合起来，**发布**成一个PDF文件，以便于在kindle等设备上阅读。这个PDF文件可以存放在Release中供大家下载。
+

README.md

@@ -1,2 +1,20 @@
-# ghdoc
-面向非程序员与非专业开发者的Github教程
+# ghdoc：面向非程序员与业余开发者的Github教程
+
+## 关于本教程
+[Github](http://github.com/)在创立的时候，主要用于软件的协作开发。因此，Github以专业开发者为目标用户进行设计。但是，由于以下原因，非专业用户有时也需要使用Github：
+
+- 开源软件用户需要下载软件并反馈Bug
+- 随着编程教育的逐步普及，出现大量业余开发者，他们也需要下载开源工具与分享自己的代码，但不需要进行复杂的版本管理
+
+本教程不涉及Git的深入使用及Github的高级功能，所有操作尽量在网页端完成，仅在必要时涉及最基本的Git命令
+
+本教程基于[Windows10操作系统](http://windows.com/)和[Edge Chromium浏览器](https://www.microsoft.com/zh-cn/edge)
+
+## 目录
+以下是已建成的页面，其他页面仍处于草稿状态。
+
+[1. Github是什么](1.md)
+
+
+## 相关链接与资源
+[Github官方中文文档](https://docs.github.com/cn)