DialogOnSoftwareProjectManagement.rst: lecture notes on 10 April 2020 (Monday section).

1 files changed, 344 insertions, 0 deletions

diff --git a/DialogOnSoftwareProjectManagement.rst b/DialogOnSoftwareProjectManagement.rst
index a4773e9..3ac5e05 100644
--- a/DialogOnSoftwareProjectManagement.rst
+++ b/DialogOnSoftwareProjectManagement.rst
@@ -6776,6 +6776,350 @@ Project check list
 
 
 
+2020-04-03 10:56:11 蓝珲(1348141770) 
+清明节我校4月4日至6日放假调休，共3天。此期间停课休息。 
+ 
+2020-04-03 13:20:17 初阳软工171 伍泰炜(2728735169) 
+[图片][图片] 
+ 
+2020-04-03 13:20:35 初阳软工171 伍泰炜(2728735169) 
+正确性测试的文件里只包含了三个测试的结果 
+ 
+2020-04-03 13:21:34 初阳软工171 伍泰炜(2728735169) 
+[图片]这两组的结果在README.txt里没有 
+ 
+2020-04-03 13:25:16 软工初阳171 应舸(1434305984) 
+@蓝珲
+有些疑问：
+
+想知道改进1的目的是什么~不太了解该工作的作用，也没理解意思，所以不知道如何入手
+
+theoretical p~v的计算方法是什么，和p~v有区别嘛 
+ 
+2020-04-03 13:29:58 初阳软工171 伍泰炜(2728735169) 
+@蓝珲 生物条件 在数据中是指什么？ category ？ 
+ 
+2020-04-05 18:50:20 蓝珲(1348141770) 
+是category  
+ 
+2020-04-05 18:51:14 蓝珲(1348141770) 
+改进1的目的是生成一个库函数 
+ 
+2020-04-05 18:52:50 蓝珲(1348141770) 
+pvalue计算需要假定一个null distribution.  这个分布可以是理论分布，也可以是经验分布。 
+ 
+2020-04-05 18:53:28 蓝珲(1348141770) 
+不是所有的测试数据我都产生了用R计算的pvalue。
+ 
+2020-04-05 18:56:12 蓝珲(1348141770) 
+你可以用2019年春季软件工程的课程主页上的testCorrelationCoefficient.R去产生p-value。 
+ 
+2020-04-05 21:07:00 蓝珲(1348141770) 
+R程序在这里: http://lanlab.org/course/2019s/se/category-specific-scatterplot/testCorrelationCoefficientPvalue.R 
+
+
+Friday, 10 April 2020
+=====================
+
+
+Morning section
+---------------
+
+
+*Clarification - Weekly review - Announcing project - Code to comment ratio - Developer documentation*
+
+
+2020-04-09 21:54:29 蓝珲(1348141770) 
+明天上课的腾讯会议ID：800 238 733 
+ 
+2020-04-09 21:54:45 蓝珲(1348141770) 
+蓝珲 邀请您参加腾讯会议 会议主题：蓝珲预定的会议 会议时间：2020/4/10 08:00-09:30  点击链接直接加入会议： https://meeting.tencent.com/s/55iZWmw1dac8  会议 ID：800 238 733  手机一键拨号入会 +8675536550000,800238733# (中国大陆) +85230018898,,,2,800238733# (中国香港)  根据您的位置拨号 +8675536550000 (中国大陆) +85230018898 (中国香港)  
+ 
+2020-04-10 8:00:14 蓝珲(1348141770) 
+大家早上好。请把学号打一下。 
+ 
+2020-04-10 8:00:22 初阳软工171 余慧(945168786) 
+201736900117 
+ 
+2020-04-10 8:00:24 初阳软工171 陈俊蕾(1223259604) 
+201736900103 
+ 
+2020-04-10 8:00:24 重新做人(1344914885) 
+201736900113 
+ 
+2020-04-10 8:00:27 初阳软工171方梓安(2453122992) 
+201736900105 
+ 
+2020-04-10 8:00:29 软工初阳171 何可人(1461938594) 
+201736900106 
+ 
+2020-04-10 8:00:29 初阳软工171袁世家(1515245651) 
+201739230123 
+ 
+2020-04-10 8:00:29 软工初阳171 刘莉莉(1196448461) 
+201736900108 
+ 
+2020-04-10 8:00:30 初阳软工171叶红霞(1655602611) 
+201736900115 
+ 
+2020-04-10 8:00:30 软工初阳171周佳威<zhouwys@qq.com> 
+201736900130 
+ 
+2020-04-10 8:00:30 初阳软工171 蒋佳玲(1850424414) 
+201732120103 
+ 
+2020-04-10 8:00:30 初阳软工171 吴贞娴(1395588359) 
+201732120108 
+ 
+2020-04-10 8:00:34 网络171—董文文(2373706002) 
+201730210303 
+ 
+2020-04-10 8:00:39 软件工程 王雪洁(249795581) 
+201732120106 
+ 
+2020-04-10 8:00:39 初阳软工171 伍泰炜(2728735169) 
+201736900125 
+ 
+2020-04-10 8:00:41 初阳软工171 王海榕(1012635788) 
+201732120105 
+ 
+2020-04-10 8:00:49 唐叶尔(1768559501) 
+201736900111 
+ 
+2020-04-10 8:00:58 初阳软工171 徐闰钞(374526027) 
+201736900127 
+ 
+2020-04-10 8:01:16 软件工程  常思琦(995959606) 
+201732120101 
+ 
+2020-04-10 8:02:29 网络171许晓鹏(892376699) 
+201730210128 
+ 
+2020-04-10 8:02:58 软件工程 张珣(1955357976) 
+201732120109 
+ 
+2020-04-10 8:03:25 软件工程初阳1701 徐梦旗(2663479778) 
+201732120124 
+ 
+2020-04-10 8:03:48 软工初阳171 应舸(1434305984) 
+201736900128 
+ 
+2020-04-10 8:04:42 蓝珲(1348141770) 
+对改进第一点疑问的释疑: http://lanlab.org/course/2020s/spm/decide-areas-for-improvement-review-class02395.html 
+ 
+2020-04-10 8:05:47 蓝珲(1348141770) 
+Rationale 
+ 
+2020-04-10 8:06:41 计非181 王智洋(1162466610) 
+201830220719 
+ 
+2020-04-10 8:09:00 网络171-侯新苗(953957823) 
+20173021304 
+ 
+2020-04-10 8:10:09 蓝珲(1348141770) 
+R程序在这里: http://lanlab.org/course/2019s/se/category-specific-scatterplot/testCorrelationCoefficientPvalue.R 
+ 
+2020-04-10 8:10:28 初阳软工171 伍泰炜(2728735169) 
+老师以后课程网页有更新可不可以把新内容做点标记
+ 
+2020-04-10 8:31:00 蓝珲(1348141770) 
+http://lanlab.org/course/2020s/spm/CodeToCommentRatio.txt 
+ 
+2020-04-10 8:31:38 蓝珲(1348141770)::
+
+    Software            Code       Comment       Code-to-Comment-Ratio
+    ------------------------------------------------------------------
+    GNU Nano                17718       3773     4.7
+    Git                    474195      63652     7.4
+    Ubuntu                 600750     120283     5.0
+    Apache HTTP Server    1512918     160160     9.4
+    MySQL                 8631127    2754165     3.1
+    OpenStack            12951523    3146489     4.1
+    Android              16218632    4849352     3.3
+    Firefox              20684598    4528549     4.6
+    Linux Kernel         36680915    6701533     5.5
+    KDE                  58707319   14434617     4.1
+    
+    
+    December 2019 Data
+    
+    Source: OpenHub https://www.openhub.net/
+    
+
+2020-04-10 8:35:24 蓝珲(1348141770) 
+休息5分钟。 
+ 
+2020-04-10 8:36:03 蓝珲(1348141770) 
+(可以，有更新的话，我会在Announcement那栏说明，你只要查看Announcement就可以了。)
+ 
+2020-04-10 8:53:24 初阳软工171 伍泰炜(2728735169) 
+output很大要写什么呢 
+ 
+2020-04-10 8:53:34 初阳软工171 伍泰炜(2728735169) 
+比如一个表格 
+ 
+2020-04-10 9:03:08 初阳软工171 伍泰炜(2728735169) 
+请问，所以测试的人还要配python环境吗，会不会太麻烦了，而且还要使用者来约束格式这种使用很找麻烦。既然都让大家保持格式了，那写个txt就够了把？ 
+ 
+2020-04-10 9:04:08 初阳软工171 伍泰炜(2728735169) 
+对啊，那只要写txt就好了是吧 
+ 
+2020-04-10 9:04:17 初阳软工171 伍泰炜(2728735169) 
+py程序你来跑就好了吧 
+ 
+2020-04-10 9:04:32 初阳软工171 伍泰炜(2728735169) 
+ok 
+ 
+2020-04-10 9:09:26 蓝珲(1348141770) 
+休息5分钟。 
+ 
+2020-04-10 9:10:27 初阳软工171 陈肖飞(1662727361) 
+201736900104 
+ 
+2020-04-10 9:20:06 系统消息(10000) 
+初阳软工171 伍泰炜撤回了一条消息 
+ 
+2020-04-10 9:20:16 初阳软工171 伍泰炜(2728735169) 
+请问theoretical p-value，是我们去年SRS需求的那个p-value吗？不是话有什么区别吗？另外“需要与R的cor.test返回的值一致。”是什么样的“一致”，是说数值准确还是说某种格式，我们想有更详细的说明确定了再往下做。 
+ 
+2020-04-10 9:20:36 初阳软工171 伍泰炜(2728735169) 
+[图片] 
+ 
+2020-04-10 9:20:43 初阳软工171 伍泰炜(2728735169) 
+这个文件没看懂 
+ 
+2020-04-10 9:21:56 初阳软工171 伍泰炜(2728735169) 
+所以这个R语言的文件是用来比对结果是吗？ 
+ 
+2020-04-10 9:22:04 初阳软工171 伍泰炜(2728735169) 
+好的 
+ 
+2020-04-10 9:24:01 初阳软工171 伍泰炜(2728735169) 
+[图片]请问这里说的，像readthedocs文档，是指在我们去年的基础上更新，还是另外开一个呢？ 
+ 
+2020-04-10 9:28:04 蓝珲(1348141770) 
+"在我们去年的基础上更新。" 
+ 
+2020-04-10 9:28:31 初阳软工171 伍泰炜(2728735169) 
+去年的是SRS诶 
+ 
+2020-04-10 9:28:46 初阳软工171 伍泰炜(2728735169) 
+行吧 
+ 
+2020-04-10 9:29:31 蓝珲(1348141770) 
+"在我们去年的基础上更新"的意思是可以重用去年的内容。  
+ 
+2020-04-10 9:29:47 蓝珲(1348141770) 
+而不是再写一个SRS。 
+ 
+2020-04-10 9:29:56 系统消息(10000) 
+初阳软工171 伍泰炜撤回了一条消息 
+ 
+2020-04-10 9:30:12 初阳软工171 伍泰炜(2728735169) 
+好的，那么我们的文档要放在哪里呢？ 
+ 
+2020-04-10 9:30:41 蓝珲(1348141770) 
+这个我也一直在想。 
+ 
+2020-04-10 9:30:44 初阳软工171 伍泰炜(2728735169) 
+个人账户下管理或者组织仓库 
+ 
+2020-04-10 9:30:47 蓝珲(1348141770) 
+你有什么好建议呢？ 
+ 
+2020-04-10 9:31:11 初阳软工171 伍泰炜(2728735169) 
+我觉得都可以，放组织下麻烦一点 
+ 
+2020-04-10 9:31:35 初阳软工171 伍泰炜(2728735169) 
+而且其实可以在项目页面加个文档仓库的链接就好了 
+ 
+2020-04-10 9:31:54 初阳软工171 伍泰炜(2728735169) 
+commit公开的也都看得见 
+ 
+2020-04-10 9:34:10 蓝珲(1348141770) 
+你们好像是有一个doc文件夹的 
+ 
+2020-04-10 9:34:10 蓝珲(1348141770) 
+https://github.com/lanlab-org/GeneExpressionScatterPlot-WuTaiwei/tree/master/doc 
+ 
+2020-04-10 9:34:34 蓝珲(1348141770) 
+https://github.com/lanlab-org/GeneExpressionScatterPlot-WuTaiwei/blob/master/doc/DevNotes.md 
+ 
+2020-04-10 9:34:45 蓝珲(1348141770) 
+DevNotes.md这个写得挺好的 
+ 
+2020-04-10 9:35:03 蓝珲(1348141770) 
+UserDoc.md, DevDoc.md 
+ 
+2020-04-10 9:35:25 蓝珲(1348141770) 
+可以在里面写UserDoc.md, DevDoc.md（DevNotes.md） 
+ 
+2020-04-10 9:36:28 初阳软工171 伍泰炜(2728735169) 
+可以，那么我们文档就以md文件的形式放在doc路径下可以吗？ 
+ 
+2020-04-10 9:36:43 初阳软工171 伍泰炜(2728735169) 
+这样也简单，而且不需要第三方构建 
+ 
+2020-04-10 9:36:46 蓝珲(1348141770) 
+当然可以，这正是我的想法。 
+ 
+2020-04-10 9:37:20 初阳软工171 伍泰炜(2728735169) 
+好的，那么命名就采用这样吗：DevDoc.md UserDoc.md 
+ 
+2020-04-10 9:37:33 蓝珲(1348141770) 
+我当时就担心使用ReadTheDocs会引入需要学习怎么用ReadTheDocs的问题。 
+ 
+2020-04-10 9:37:45 蓝珲(1348141770) 
+这样的文件命名很好。 
+ 
+2020-04-10 9:38:10 初阳软工171 伍泰炜(2728735169) 
+老师可以罗列一下你对两个文档具体的要求吗，比如哪些方面是必须要包括的 
+ 
+2020-04-10 9:38:13 蓝珲(1348141770) 
+作为软件工程课，让你们熟悉一下ReadTheDocs是很好的。 
+ 
+2020-04-10 9:39:29 蓝珲(1348141770) 
+两个文档面向的读者不同，UserDoc.md是主要面向（鼠标点击）用户的，告诉他们怎么使用软件（有点像使用说明书）。 
+ 
+2020-04-10 9:40:11 蓝珲(1348141770) 
+DevDoc.md则涉及实现的技术细节，以及如何参与项目的协作，这两块主要内容。 
+ 
+2020-04-10 9:41:58 初阳软工171 伍泰炜(2728735169) 
+您有空的时候，考虑一下要求再补充到课程网页上吧。这样一句话讲挺抽象的。 
+ 
+2020-04-10 9:42:49 蓝珲(1348141770) 
+没有十分固定的格式。 
+ 
+2020-04-10 9:43:26 初阳软工171 伍泰炜(2728735169) 
+好的 
+ 
+2020-04-10 9:43:51 蓝珲(1348141770) 
+我有细节会添加的。 
+ 
+2020-04-10 9:45:25 蓝珲(1348141770) 
+你可以复用你之前写的很多东西，但是要注意两类文档面向的不同读者群。 
+ 
+2020-04-10 9:46:17 蓝珲(1348141770) 
+
+.. image:: TIM20200410102924.png
+   :height: 100
+   :alt: Developer documentation
+
+2020-04-10 9:46:32 蓝珲(1348141770) 
+
+.. image:: TIM20200410102930.png
+   :height: 100
+   :alt: Documentation
+
+2020-04-10 9:46:49 蓝珲(1348141770) 
+
+.. image:: TIM20200410102935.png
+   :height: 100
+   :alt: Documentation
+
+
+
+
 How to cite
 =============