一经你拜候上边这几个 GitHub repo,会发觉它记录的是一部法典:

Udacity的Machine Learning微米学位课程中,关于Github的笔记。

【汇新云】为我们准期更新随笔,【汇新云】IT人的行当链平台

听课范围:
Github Profile
Git 和 Github
Readme


澳门葡萄京官方网站 1

Profile
Readme
Commit
Contribute to open source community

GitHub 网址在技师心目中的地位显明,这些基于 Git
的托管网址能够说是开源的风向标。 大家 GitHub 中的 Git repo 中还足以找到
贰零零柒 年 4 月 8 日 Linus Torvalds
提交的 第一版 代码。

那是美利坚联邦合众国Washington哥伦比亚共和国特区(Washington District of
Columbia,WDC/DC)的法律条目款项,它不是准绳的别本,而是一个权威的 DC
委员会存款和储蓄已发表法律的数字版本的地方,内容一直提须求理事会的 DC
条约网址:https://code.dccouncil.us/dc/council/code。

课程听了大意上,笔记继续修改,有待排版。

幸亏 GitHub
网址在国内外的中标运营,加密数字货币开源项目才会以发生性的提升。这些世界上最一流的程序猿都在为那么些开源项目交付
P奇骏,这种社区式连接的技术,是力不胜任衡量的。大家得以在 GitHub
上看到 Bitcoin、Ethereum、EOS 等档期的顺序的最新更新状态,每一日都有成都百货上千的程序员为那几个品种避风挡雨。加密数字货币的共鸣,十分大片段起点GitHub 社区。

N年前,DC
律师与软件程序员开采,在追踪代码更换时,立法和软件工程有过多协同之处,于是他们说了算将准绳条目款项托管到
GitHub。他们成功实行了该布署,于是有了下边提到的那些 GitHub repo。

show your work and how you work

澳门葡萄京官方网站 2

不错,那是三个实打实而有意义 repo,它是能够透过 P索罗德 实行更新的,近年来黑客
Joshua Tauberer 
还发布文书介绍了他为该法典提交了四个错别字 P奥德赛并被选择的案例。Joshua 开掘条目中那句描述现身谬误:

澳门葡萄京官方网站 3

题图来源: © EarlGrey / Migrate to Qcloud Git Server / codingpy.com

(d) The Office of Open Government may issue advisory opinions on the
implementation of subchapter I of Chapter 5 of Title 2.

照片
twiter,个人博客

那 Git
毕竟是怎么吗?轻易讲便是一个 布满式版本调节软件。假使用三句话阐述如何是
Git 运营规律,那正是:[1]

其间,“subchapter I” 应该为 “subchapter II”,于是 Joshua 提了一个 PENVISION改善该错误。几天后,委员会的编写律师将其统一:

recruiter最早看的是此处,看您有多活跃,大概每日都会coding。

变动修正过的公文

澳门葡萄京官方网站 4

点进二个最popular的contribution的repository,能够见到scott做了最多的贡献,写了非常多代码。

调换当前目录 tree 文件,关联当前景况文件

当然地,DC 条目网址也自动更新了该处失误:

澳门葡萄京官方网站 5

生成 commit 文件,关联到当前目录 tree 文件,并记下父 commit

澳门葡萄京官方网站 6

页首加了get hub page for this library。

咱俩来试着明亮那句话。当大家在 GitHub 创设三个新品类再 git clone
到地头(当然也能够本地 git init
初叶化项目),把本地的代码放到这些目录,然后我们要怎么提交到 GitHub
呢?大家在安插相应的 SSH 公钥之后,会实行如下的多少个步骤来交给到 GitHub:

自然了,因为这是手艺性错误 request,所以它能够被接受。

澳门葡萄京官方网站 7

git add -A .

Joshua 认为,在 GitHub
上拆穿法律条目款项是一项真正的内阁履新,它改换了历史,具体意思体以往那多少个方面:

readme是repository里最重大的局地之一。
有利其余人阅读和动用代码。

git commit -m “[Blockchain] …”

  • 理事委员会可以比往年越来越好、更加快地发表准绳。今后律法每年一次揭橥一回创新,并且只怕会有五到7个月的延迟才具见到最新版本,不过,开源收缩这么些进程,新的法律揭橥约一个礼拜后民众就能够看出。

  • 那也意味,相比较过去公众能够接收到越多法律条文。

  • 法律配套公布在四个易用、今世化、可搜索、移动自个儿且免费的网址上,也正是上边提到的 https://code.dccouncil.us/dc/council/code。

  • 那给条件有限而没办法具备更加好的工具去探讨律法的大伙儿和律师提供了愈来愈多机缘。

comments里面能够投入版本的表明,feature扩大的表达等。

git push origin master

还要 乔希ua 也可望任什么地区方向 DC 学习,通过开源库推动律法的迈入。

澳门葡萄京官方网站,hiring manager的职责 figure out what attributes do value in engineers。

简单易行讲就是,先地点提交,积攒两次后再三次 push 到
remote。此次交付会波及到上壹次提交,那跟区块链的 chain
是或不是有些相像?比如本次交付的证明为 ab88b43,上一遍提交的标记为
297f29a,那么此次交付的音讯里就能够有 parent commit
297f29a。这种看似链条的记录,是还是不是变得可追溯了哟?版本调控最重视的是何许,就是可追溯,即使某次错误付出,还是能够回腿到历史版本。相仿,可追溯也是区块链的重大特征。

(文/开源中中原人民共和国卡塔尔(قطر‎    

率先要看的,就是活跃热图,看浅湖蓝的布满,看此人是还是不是热爱编制程序。是或不是日常做贡献,不须要连接在编制程序,但起码会有比较稳定的可行性。

再者,区块链的性状是布满式的,而 Git 天然就是布满式的,可是 Git
是信任文件系统。GitHub 助力环球化合营,并且代码可能文书档案一旦付出到
GitHub,那一个操作将是无可奈何收回的。GitHub 本人会将其网址上的 repo
利用布满式存款和储蓄做好容灾;要是某程序猿 clone 该
repo,只要它不删除,将会永久存款和储蓄在本身的Computer,除非本身Computer文件系统崩溃;如若某程序员fork 该 repo,只要它的账户不被删除,这一个 repo
将生生世世保存在它的账户之下;其余,有些 repo fork、clone
次数越来越多,被摧毁的可能率也就越低;再者,有个别 repo
就算方今叁次操作清空了颇有的代码,还是能通过 git log
苏醒。那样一剖判,科学上网的 GitHub repo
将是 春风吹又生,春风吹又生

接下去看这厮树立的repository,和她孝敬过的repository。
挑一个最丰裕的repo,花叁个时辰去读他们的code,进而观望他们是怎样的技术员。
也会看他是不是在其余repo中有贡献,看她什么和他人相互作用,协作,研究。

许多正式大牌的文章都寄放在
GitHub,读者会被删吗?近年来一天世界的一篇关于Wechat的稿子很有趣,不要紧 看看。


除此以外,区块链的另三个特色是不可点窜,也正是必须要 INSERT。Git 呢?GitHub
托管的 repo 里的剧情自己是足以修正的,然则那个 commit
历史却是不恐怕改良的。每叁遍 commit 都有独一标记,此次 commit 会有 parent
commit 的音信。Git 发生的 log 也足以通区块链数据库进行类比。

写readme

也正是说,Git 是简化的 blockchain,用 Git
来掌握区块链,那些事情是或不是刻意有趣?

便利自个儿纪念code,回头再看看您写过的代码,你是否还记得您即刻是怎么想的啊,是还是不是还记得你及时怎么办了那些决定吧,便于外人接受,便于外人合营。

参考

看什么接受这一个code,有未有example,若无好的document,外人就能转接其余更平价的library,假使非要读那样的code,就会费用非常多岁月,

[1] douban.com (二〇一二-07-18卡塔尔国. 三句话的 git internal. Retrieved
from https://www.douban.com/note/289253352.

澳门葡萄京官方网站 8


Paste_Image.png

学好区块链,拥抱新前程:

澳门葡萄京官方网站 9

区块链成品董事长(点击入驻),和圈夫职员混个脸熟

https://github.com/thoughtbot/factory_girl
https://github.com/zkat/can.viewify
https://github.com/udacity/create-your-own-adventure

类型简要介绍,Description
别的文书档案,Documentation
安装,Install
外加新闻:Contribution,当您想让别人更方便人民群众地参预进来,大概Issue
License

看下边那么些例子
https://github.com/github/ledbetter

readme须要提需要user充足的新闻以便于up and running your code

题目
陈说:一两句,清楚并且精准地描述项指标精髓

Installation, common Usage, known Bugs
readme的长短决意于你的类型,没有必得的渴求,只需求提供给使用者需求的新闻。

澳门葡萄京官方网站 10

copyright和licensing information,或者link。
上边那些网址,能够学学怎么选license。
http://choosealicense.com/
这里有关于license的指南,
https://github.com/blog/1530-choosing-an-open-source-license
此间能够告诉你为何要选license,以致不选license的情事:
https://help.github.com/articles/open-source-licensing/

建立license很简单:

澳门葡萄京官方网站 11

澳门葡萄京官方网站 12

澳门葡萄京官方网站 13

提供一下早已理解的bug,那样客户就绝不发愁怎么他的code不能成功运营。

澳门葡萄京官方网站 14

用markdown写readme,易读,并且制版轻易。
Github,Stack Overflow,Slack,Reddit

Here’s a link to the basic Markdown
documentation.
You can also check out the differences in GitHub flavored Markdown
here.

github中常用markdown命令
加粗
Isn’t today a wonderful day?
斜体
And in that moment I thought to myself: Did I turn off the stove?
代码
You should use the strong tag.
标题

This is an h2.

Working with .md
Files
Much like how your HTML files should be saved with a .html
extension, your Markdown files should be saved with a .md
extension.
Markdown itself can’t be opened in the browser like an HTML document. If
you want to preview your Markdown files,
Dillinger is a great
online resource for you to do so.
If you are using Sublime Text, there is a
plugin
you can download to let you preview Markdown files right on your
computer. If you are using Atom text editor, Markdown preview is baked
right into the program (in the ‘Packages’ menu).

Here’s a link to the basic Markdown
documentation.
You can also check out the differences in GitHub flavored Markdown
here.
To preview Markdown in the browser, try
Dillinger.

怎么特不佳用,上面那么些好用
http://dillinger.io/


well formatted commit messages

让外人知道,为何那边有诸如此比的code,曾几何时做了怎样的改善。
福利别人解读,使用,维护您的代码。
hiring manager会看此人有多么地善用沟通,传递。

Udacity上的例子
http://udacity.github.io/git-styleguide/

The first line is the subject.This should be a short description of what
changed.should be 50 characters or less, with the first letter
capitalized, and end without a period. At Udacity, we also include a
short annotation about the type of the commit, if it is a bug fix, a
feature, change to the documentation, etc.

The body is next, this is where you give a more detailed description of
why you made the change. The body should typically have around 72
characters per line. This is to ensure that the message fits into a
terminal window when using git on the command line. You’ll also need to
make sure there is a blank line between the subject line and the body.

Some commits don’t require a body in the message. If you fix a typo for
example, it’s okay to only have a subject line.
You can also include a footer, typically this will be used to indicate
which issues or bugs the commit addresses.

This does come with an exception of course. If you are working on an
open source project, be sure to follow the message format for that
project. This will make the maintainers happy and increase the chance
your pull request is accepted.

从您的代码里可以看出,你是或不是长于同盟,中意扶植人家,並且热爱编码。
面试官是怎么着从您的github上看看你是个好的协作者的,在叁个协会里是怎么表现的。
看她们出席的repo里的issue,
是否在on po requests里评论,
看他俩哪些与任何技术员相互影响。
看他俩是或不是有意志力对待刚进入这些社区的成员,
找找是或不是有internet relay chat关联于那几个repo,
看log,看他俩是不是helpful,kind,patient。

作为hiring manager,你想向new
programmer提些什么建议,关于她们在列席contribute
to十分大很复杂的开源项目中。
break the ice in a new project,
找文书档案看,readme,clone the project,try to build it, try to get it
running, follow the steps in readme.
try to clarify some problems I have, submit a poll request with a few
changes in the readme.
just move on to fix the bugs, and maybe actually contributing the
features.


怎么样为开源项目做进献

Github
https://guides.github.com/activities/contributing-to-open-source/
找一些最欢腾的开源的library,pandas:
https://docs.google.com/document/d/1ULcO23Edlydaf82zycRdSWHKUme5pmNnC4OoMefIZ-c/pub

python: pandas, numpy, scipy, seaborn, scikit-learn, orange, nltk
r: dplyr, ggplot come to mind
also ‘stan’ for r
pymc for python as well.
http://www.datakind.org/
http://databits.io/
for data and data vis related competitions
https://www.kaggle.com/

  • Kaggle is a platform for data prediction competitions. Companies,
    organizations and researchers post their data and have it scrutinized by
    the world’s best statisticians.

读documentation,不会的标题就create issue,寻求扶植。
创制issue,这一个类型的,也足以是您自个儿的,
要nice,都是public的,
最好的contribution方式,就是improve the documentation。

澳门葡萄京官方网站 15


check list
https://docs.google.com/document/d/1a9AKnNyqfGgdQV5ohPCN5H9ntnEUhMptWMwVBWURCN0/pub?embedded=true

GitHub Profile Checklist

澳门葡萄京官方网站 16

= Optional Udaciousness
Link to associated GitHub Profile
Rubric

General
I’ve uploaded at least four projects to GitHub.
I’ve verified that my account shows knowledge about how to make
incremental commits.

澳门葡萄京官方网站 17

For the last two weeks, I’ve made and pushed some sort of commit, no
matter how small, to repo(s) each day.

澳门葡萄京官方网站 18

I have more than 2 projects on GitHub, indicating that I have uploaded
more projects than required.

澳门葡萄京官方网站 19

I’ve contributed to an open source project.

Personal Profile
I have a professional GitHub name. If at all possible this GitHub name
is my own name.
I have a professional profile photo (recommended to be a photo of
yourself, but could also be stylized).
My profile is up to date.
Profile includes at least one up-to-date links for: ‘URL’ and/or
‘Company’ fields and/or ‘Contact Email’ and current location.

Projects
I have starred at least one repository I’d like to keep track of.

澳门葡萄京官方网站 20

My projects have meaningful names.

My projects have a completed README that says what the purpose of the
project is, any instructions about how to use or view it, and what kind
of collaboration is sought.

Not all forked repos/changes require modifications to the README,
especially when contributing upstream to another’s project (would need
to be a substantial change). All changes should be documented with
commit messages to explain the changes.

The last commit I made to a project matched the commit style guide I
chose. If I did not follow the Udacity git commit style
guide,
then I have included a link to the guide I did use to show consistency.

career resource

http://career.udacity.com/resource-center/contributing_open_source.html

end