[WIP] Git & HTML

[arrowrowe]

Ch2 主讲 @swaylq 2016/04/04 21:00 Rotunda

[arrowrowe]

关于对 @swaylq 之前写的 Git 系列的建议,

• Try Git 0x00
  • 先交代为什么要用版本控制, 为什么要有分支. 第一张图片确定不会太吓人?
  • 历史和安装可以留作课后阅读和实践.
  • 基本操作
  • 可以结合 GitHub 上开新仓库, clone / init / remote add 都在提示里.
  • status 讲一下常见的 status?
  • push 和 pull 的文字说明有点生涩?
• Try Git 0x01
  • 概念太多了. 之前不懂的话, 听完多半还是不懂......
• Try Git 0x02
  • 远程
  • Remote 部分没必要讲吧? 介绍一下 git-extras? 然后用 git info.
  • 远程分支管理感觉讲多了, git checkout -b new-branch 和 git push -u origin new-branch 就够了.
  • 为啥再讲一遍 push / pull?... 其实建议新人只用不带参数的形式, 省得出现奇怪的事情 - -
  • 感觉 fetch 没必要讲.
• Try Git 0x03
  • Rebase 可以留作课后实践.
  • 分支规范可以直接讲工作流, 参考 git-recipes / 3.5 常见工作流比较, 我们讲一个它的极其精简的版本就行了. 这里可以捎带一下 PR (MR)? 然后催一下上学期加来的同学们把自己加进通讯录.........

总之, 概念少而清晰, 讲最少最少的命令, 留适合的阅读和实践.

---

其他建议,

• 推荐 oh-my-zsh, 原因
  • 默认的 git-status 挺好的, 换 git-radar 之类也不错.
  • 可以稍微介绍一下 alias | grep git 的含义. OMZ 定义的很多关于 git 的 alias 都很实用, 可以留做阅读实践. (还可以留 Git 自己的 alias.)
• 推荐几个 cheatsheet, 比如 GitHub Git Cheat Sheet, Git Cheatsheet.
• 推荐一些练习... 比如 Learn Git Branching, Learn Git and GitHub......
• 推荐更深入些的阅读, 比如 Git - Reference. (上面俩 cheatsheets 就这里的...)
• 要不要顺带介绍些最基础的命令...... cd / mkdir / rm / ...... 留作阅读实践的可以是安装些东西... 比如 tree / ag / jq / nvm / pip / cheat / git 2.8.0...... 话说上周作业对命令行的要求到哪里了? 我还没看作业......

---

抄送 @at15 @ComMouse @LukeXuan

[at15]

@arrowrowe 作业我还没 update (不过我猜也没人去看，我们应该加个谷歌统计

我的意见分两部分，一个是课程相关的，一个是跟git相关的

课程上

• slide 用 revel 的好处是可以导出成pdf，这样看的方便，你要觉得看电脑难受，可以打印出来(我现在就是这样，老了....) 另外比 ppt 方便，放在网页上可以直接看。
• doc 是用 readthedoc 托管的，为了能导出pdf和搜索用了 sphinx, sphinx 语法不是太复杂，我在 doc 里也提到了它的tutorial，看之前的几个 rst 也能知道怎么写，另外也支持用 md，不用 rst 特性的文件，用md写就可以了，还有就是 make 的时候注意要没有 warning。
• 课程的网站就是 gh-page 的纯 html, 另外 slide 也放在gh-page里了，revel的js用的是 cdn
• 课程准备最好早点开始，我当时想的是周四周五写，结果最后周六周日还有周一一直都在写。
• 另外课后的作业，我觉得还是组织一下实际见面的检查比较好，让自己去做的话，应该没几个会去做，而且讲座的时候也不会有那么多时间去看每个人做的怎么样，等后面基本的东西，环境，git都会了，作业再全放到线上也可以。
• 宣传的活动可以提前放出去了，可以弄个海报之类的 @scottsun94 或者我画个二次元的也可以。而且也有往期的可以参考了。
• 最好每节课的课前通知需要准备什么 比如，先给个文档，告诉怎么安装 git bash，这样也不用干听，自己也可以动手。像我的那个其实应该先通知把vagrant vbox装好。

Git

• 图形化工具是应该介绍的，豆豆那天晚上不是跟咩说了很多 @ComMouse @arrowrowe
• 复杂的概念并不需要讲太多，一开始只知道有 origin 和 master 也不是问题，等先会单分支工作之后，再介绍pr的workflow更好一些，否则没有写实际项目，塞一堆概念，会混了或者什么都没记住。
• 以前我们学git的时候 @tq5124 他们推荐过一个图形化的学习网页，可能有点用。(虽然我没怎么用....)

[at15]

@arrowrowe 命令行应该还是要讲一下的，你可以补充到我那个分支里，我文档里有 command line 的部分。

[arrowrowe]

re @at15

• Reveal 和 Sphinx 都挺好的... 支持
• 课程准备越早越好... 然后也能早点通知下次讲啥.
• 作业... 这两节还不急. 以后线上检查好了.
• 宣传其实也不是很急......
• Git 图形化乾乾有提到, 0x00 里.
• 多分支提一点点就好, 剩下放到实践里.
• tq 推荐的是啥来着 0.0
• 命令行的内容为啥放到你那个分支...... 那儿都讲完了为啥还加新内容......

[at15]

@arrowrowe 你看下那个文档和 #2 slide里的内容比文档少很多，这样后面的 slide 重复的内容在 doc 和 slide 里可以直接链接过去。

tq 他们推荐的是 http://pcottle.github.io/learnGitBranching/

[arrowrowe]

re @at15

• 更新到你那边也好... 算是归个类?...... 讲的时候跳过去 = =......
• tq 推荐的那个我有提到......

[ComMouse]

Git 的难点是工作流和分支管理，这个应该是重点

[kkksc03]

从某种角度来说，简单粗暴的svn，在不是很需要复杂的功能情况下，也是不错的。

[swaylq]

• 我不推荐把 git, editor, html 放在一起讲，因为我个人感觉就教学而言，git 相对于其他两个的比重过高了
• 感觉 git 还是需要讲很多的，就算讲的都是最基本的东西
• 目前打算
  • git 介绍（意义，历史）
  • 多个平台下的安装，不同客户端的使用
  • 本地工作流
  • 分支的简单运用
  • 团队合作
• editor 我暂时也想不到说什么，自己平时也没什么研究，而且上一节课也说了
• html 我可能会说一下 Web 前端的基本工作原理，说下从收到 html 字符串到最终看到页面这其中发生了什么

---

另外，这次的课程结束我可能会附加一个 15 分钟 express 搭建简单后端的小教程，作为附加课

[at15]

@swaylq 我觉得分支的简单应用，讲了大部分人也一下子听不懂，多平台下的安装的话，只要说 win 就够了，其他的放文档好了，用来讲太浪费时间。

express搭后端这个我不太推荐，很多人其实什么都还没搞清，然后发现js前后端都可以写，反而会更混乱。

还有你直接开分支就好了，不要用自己的fork，这样别人也可以直接改。

[swaylq]

re @at15 ，打算在分支下写的，随手 fork 了一下，分支的话我尽量讲的简单把，我觉得不讲 分支的话也没什么意义……倒是本地工作流大家不一定能听得懂，安装的话肯定不会讲多的，而且在发布活动的时候完全可以把安装的文档放出来让大家来安装。

express 搭后端是出于私心考虑，我倒时候会提醒大家接下来是附加课，可以不听。讲的原因是院里在做嵌入式大作业，需要用这个搭服务端，另外项目中需要用到。

---

btw，我可能会把 win 下的安装空出来让你们补充

[at15]

@swaylq .... 主要就是win下的安装吧....

[at15]

@swaylq you should also mention common problems like CRLF, better have a single chapter for common problems (FAQ).

• CRLF
• Encoding
• Conflict
• Can't push (http buffer)
• Add ssh key
• ssh key passpharse (linux password has not hint)

etc. cc @arrowrowe @ComMouse