Review to learn and ace your DS interview

No one is the only person who knows a specific part of the code base. Simply put, code reviews help facilitate knowledge sharing across the code base and across the team.

我们是一个交流机器学习实践的社区，通过社群学习的方式来 review 有代表性的 notebook 和 ML 项目，积累机器学习的有效实践、面试经验和知识内容。欢迎投稿和建议，请提交 issue。

如何参与

• 成为社群成员，介绍自己，为本 repo 和 wiki 贡献有价值的内容和反馈。
• 尽量参与 weekly review meeting，成为主理人 (host) 和协理人 (facilitator)。永久 Skype 会议链接:

The Zen of Reviewing a Notebook

by suredream
- agility is better than faultless
- practicality beats fancy
- readability always matters
- topdown
- though eternal, uncertainty has to be measurable
- indispensable intellectual curiosity

如何进行

• 会前，由本周 host
  • 选择并发布本周的 notebook (example)
  • 更新日程到本 repo
  • 提供与本周 review 有关的参考列表到这里。
• 会前，参与者
  • 通过reviewnb对本周的 notebook 进行 review。
  • 提交其它问题到对应的 issues 中。
• weekly review meeting (1hr)
  • 会议时间通过本 repo 发布，skype meeting连接
  • 由 host 简要说明其原理、应用前提、优缺点，最佳实践 (10 min)
  • host goes through notebook (motivation, problem, data, model, 5 min)
  • host 点评之前的评论 (5-10 min)
  • host drive 自由讨论, facilitator 记笔记。(20-25 min )
  • host / facilitator 进行小结 (10min)
  • 确定下期活动的 host 和 facilitator (5min)

如果你是 host

• 填写报名表
• 联系人会与你协调时间
• 在群中发布消息，包括，notebook 的简要介绍，reviewnb 地址，更新日程
• 组织讨论，分享你了解的知识，提供充足和准确的参考材料
• 持续更新相应的 wiki 页

如果你是 facilitator

• 不需要你对本议题有很充分的了解，你通过分担 host 的部分工作量
• 帮助发布活动消息和回答非技术性的问题
• 在会议过程中作记录，尝试区分要点和重要信息
• 讨论结束时，从自己的角度提供小结
• 会后，协助 host 完成 wiki 页

如果你是 invited reviewer

• 我们需要经验丰富的你来提供洞见和业界的最佳实践
• 你的专业意见会被记录在 wiki 页中，并注明出处
• 你会在社群里成为有影响力的专业人士，你的意见会受到特别的重视
• 我们会努力让你同样能够受惠于社区的文档，on the top 整个行业的发展

如果你是 ML beginner

• 我们需要你问好的问题，收集和记录好的答案
• 你可以在 issue区 提请大家注意新的文献、模型、工具
• 你可以在群里寻找 mentor，并建立互惠的 mentorship 关系
• 帮助宣传我们，使得更多的人参与进来

如何使用 reviewnb 在 notebook 上进行评论

阅读其文档。

飞行规则 flight rules

• git 飞行规则
• ml 飞行规则