update Lab1.md
This commit is contained in:
ufh1tx4asd
parent
f045bb88a3
commit
345c3d7c69
|
|
@ -10,8 +10,8 @@
|
|||
|
||||
1. 如果你还没有GitHub账号，请注册一个GitHub账号。
|
||||
2. 将GitHub账号以邮件/微信形式发给助教，助教发送GitHub邀请到[OSS-Dev-Course-PKU](https://github.com/OSS-Dev-Course-PKU)组织，Lab 1、Lab 4和Lab5中涉及操作GitHub的部分均会在此进行；此外，后续的课程项目也会以此处告知的GitHub账号为准进行评分。
|
||||
3. 在[OSS-Dev-Course-PKU](https://github.com/OSS-Dev-Course-PKU)中创建一个GitHub仓库，名为`2023Fall-{学号}-Lab1`。
|
||||
> 例如，如果学号为2000012345，那么仓库名应当为`2023Fall-2000012345-Lab1`。
|
||||
3. 在[OSS-Dev-Course-PKU](https://github.com/OSS-Dev-Course-PKU)中创建一个GitHub仓库，名为`2023Fall-{学号（十六进制）}-Lab1`。
|
||||
> 例如，如果学号为2000012345，那么仓库名应当为`2023Fall-7735c439-Lab1`。
|
||||
|
||||
4. 在自己的个人电脑上安装git，初始化一个git repository。
|
||||
> 网上存在大量关于如何在Windows/Mac OS/Linux安装git、初始化git repository、和添加commit的教程，我们在此推荐[MIT的Git教程](https://missing.csail.mit.edu/2020/version-control/)和[Pro Git前五章](https://git-scm.com/book/en/v2)，也可自行搜索参考其他教程，在此不再赘述；除命令行外，VS Code等IDE也提供非常便捷的git操作GUI。
|
||||
|
|
@ -26,7 +26,7 @@
|
|||
8. （建议上过一周课程后再继续这一步）相比较于上一次，你的贡献想法和计划发生了什么变化？请在你创建的GitHub仓库中开启一个issue，用一句话描述贡献想法和计划的变化。
|
||||
> 在真实的开源项目中，Issue和PR的内容通常会有规定的[模板](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)，以便于维护者快速地处理新的Issue和PR；在本Lab中，因为相关的issue和PR过于trivial，故不对内容作任何要求；但是需要额外注意，如果在真实的开源项目中提交issue和PR，通常需要严格遵循其规定的贡献指南。之后的Lab中涉及到对成熟开源项目的贡献指南的观察和分析。
|
||||
|
||||
9. 将你创建的GitHub仓库fork到你自己的账号下，新建一个分支，并在新分支中添加一个或者多个新commit，将想法的变化更新在README.md中，随后切回主分支main删除其中README.md的内容并提交删除commit。此时，在你创建的GitHub仓库中开启一个PR，将新分支合并入主分支main，解决存在的冲突，设置reviewer为助教，等待助教合并PR。
|
||||
9. 将你创建的GitHub仓库fork到你自己的账号下，新建一个分支，并在新分支中添加一个或者多个新commit，将想法的变化更新在README.md中，随后回到[OSS-Dev-Course-PKU](https://github.com/OSS-Dev-Course-PKU)中你创建的GitHub仓库，删除其中README.md的内容并提交删除commit。此时，在你创建的GitHub仓库中开启一个PR，将fork仓库中的新分支合并入[OSS-Dev-Course-PKU](https://github.com/OSS-Dev-Course-PKU)中仓库的主分支main，解决存在的冲突，设置reviewer为助教，等待助教合并PR。
|
||||
> 在Lab 1中，你有直接合并PR的权限；在真实的开源项目中，通常只有核心维护者具有PR合并权限，需要通过一轮或多轮[Code Review](https://en.wikipedia.org/wiki/Code_review)，才能合并PR里的变更；此外，开源项目在开发过程中通常会选择在不同的[分支](https://docs.github.com/zh/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)中同步完成不同的开发工作从而使得不同的开发互不影响，但在合并分支的过程中，如果仓库内的不同分支同时对相同文件进行了更改，通常会产生conflicts，此时需要人为进行检查[解决合并冲突](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/about-merge-conflicts)，才能合并以获取分支中的最新更改。
|
||||
|
||||
## 评分标准
|
||||
|
|
@ -35,7 +35,7 @@
|
|||
- （1分）Repository中有README.md，按要求书写了commit message。
|
||||
- （1分）README.md有开源项目的贡献想法和计划。
|
||||
- （1分）按要求open issue。
|
||||
- （1分）按要求fork repository、新建分支并在新分支与主分支中同时提交commit修改。
|
||||
- （1分）按要求fork repository、新建分支并在fork仓库的新分支与原仓库的主分支中同时提交commit修改。
|
||||
- （1分）按要求提交PR合并分支并解决产生的conflicts。
|
||||
- （1分）贡献想法体现出了对开源项目的了解和自己的认真思考。
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue