首页 > 其他分享 >构建之法阅读笔记

构建之法阅读笔记

时间:2023-03-31 20:26:35浏览次数:45  
标签:复审 代码 编程 笔记 注释 构建 开发者 阅读 ASCII

 第四章《两人合作》。

本章主要涉及代码规范,极限编程,结对编程,两人合作不同阶段,影响他人技巧几方面的知识点。以下是我的问题:
1. 原文:注释(包括所有源代码)应该只用ASCII字符,不要用中文或特殊字符,否则会极大的影响程序的可移植性。

根据对注释的解释,注释就是对代码的解释和说明,其目的是让人们能够更加轻松地了解代码。注释是编写程序时,写程序的人给一个语句、程序段、函数等的解释或提示,能提高程序代码的可读性。注释是为了让人们了解代码,为什么只能用ASCII字符,对于使用别的语言的人来说,强制使用ASCII注释会不会增加对注释的理解难度。对于中文注释的问题,是不是应该适度放宽,毕竟注释就是为了能让简单直白的明白代码而存在的。

根据知乎上的“大型公司代码注释是怎样?”这个问题有以下评论。

在我看来,ASCII注释可能在国际的运用率和广泛度比较高,因而导致的此种注释规范。但是根据实际情况,结合平常习惯和以上评论,我认为因地制宜的代码注释可能会比固定的代码规范在一定程度上效率更高。对于内部而言,只要能使团队人员理解,代码注释风格可以随自己决定,但在交流学习方面,可能ASCII注释的广泛度会更高

关于编程注释规范方面的博客:https://blog.csdn.net/xiaoxiaopengbo/article/details/51583631

2.原文:

“软件工程中最基本的复审手段,就是同伴复审。

谁来做代码复审?即最有经验,熟悉这一代码的人。对于至关重要的代码,我们要请不止一个人来做代码复审。”

“在代码复审中发现的问题,绝大多数都可以有开发者独立发现。从这一点说,复审这是在替开发者干开发者本该干的事情。”

标签:复审,代码,编程,笔记,注释,构建,开发者,阅读,ASCII
From: https://www.cnblogs.com/wllovelmbforever/p/17277376.html

相关文章

  • 人月神话读书笔记2
    第七章—为什么巴比伦会失败?巴比伦的失败是因为缺乏交流。他们无法交谈,从而无法合作,以至于工作陷入停顿。因为不知道对方在做什么,许多小组修改自己程序的功能、规模和速度,他们明确或者隐含地更改了一些有效输入和输出结果用法上的约定。由于对其他人的各种假设,团队成员之间的理解......
  • ETCD源码阅读(三)
    DAY2:阅读raftexample:etcd/contrib/raftexampleserveChannels()func(rc*raftNode)serveChannels(){ snap,err:=rc.raftStorage.Snapshot() iferr!=nil{ panic(err) } rc.confState=snap.Metadata.ConfState rc.snapshotIndex=snap.Metadata.Index r......
  • ETCD源码阅读(二)
    DAY1:阅读raftexample:etcd/contrib/raftexampleraftexample包括三个组件:一个基于raft的kvstore、一个RESTAPIServer、一个基于etcdraft实现的RaftNode。其中RaftNode也拥有一个Httpserver,用于与peer节点进行通信。RESTAPIServer则是这个RaftNode的client。kvs......
  • ETCD源码阅读(一)
    DAY0:ETCD架构下图中展示了etcd如何处理一个客户端请求涉及到的模块和流程。图中淡紫色的矩阵表示etcd,它包括如下几个模块:etcdserver:对外接受客户端的请求,请求etcd代码中的etcdserver目录,其中还有一个raft.go的模块与etcdraft库进行通信。etcdserver中与......
  • 2023年3月31日(软件工程日报)人月神话读书笔记3内容
    第8章:胸有成竹软件工作量是根据规模成指数型增长的,指数大约是1.5,即:工作量=常数×指令的数量1.5工作量=常数\times指令的数量^{1.5}工作量=常数×指令的数量1.5实践是最好地老师实践是最好地老师,但智者还能从其他地方有收获。第9章削足适履这一章讨论了内存......
  • 【做题笔记】树形 dp
    1.luoguP2016战略游戏1.1Solve设计状态\(dp[i][0/1]\)表示在\(i\)子树内,放/不放第\(i\)个节点使其合法所需的最少的士兵数目。则有:不选\(i\)节点,则\(i\)的儿子必须选;选\(i\)节点,则\(i\)的儿子可选可不选;因此,转移方程为:$dp[i][0]=\sumdp[son[i]][1......
  • kafka学习笔记
    一、初识kafkakafka的数据单元被称为消息,为了提高效率,消息会被分批次写入kafka,批次就是一组消息,这些消息属于同一个主题和分区。批次数据会被压缩,这样可以提升数据的传输和存储能力,但要做更多的计算处理。kafka的消息通过主题进行分类,主题可以被分为若干个分区,消息以追......
  • 呼叫中心系统是如何构建的?
    呼叫中心系统的建设需要从三个方面考虑,一般可以分为:业务规划、应用集成和实施能力。让我们来看看呼叫中心系统是如何构建的?1.商业计划。首先,要确定公司的运营机制是服务型的还是运营型的。不同的业务需求将构成建设不同呼叫中心系统的要求。呼叫中心系统主要提供产品营销、电话......
  • gulp笔记 2 (进阶一点点:使用bower来管理前端依赖)
    其实gulp比例1中的内容已经基本满足开发要求了。此文为进阶的一点点知识#1 安装bower(bower是个纯web前端依赖管理工具。)   npminstall-gbower #版本为1.8.14,必须安装在全局   bowerinit#会生成一个bower.json文件,选项寂寞默认就行,bower的库户自动放到bowe......
  • 如何基于MLServer构建Python机器学习服务
    文章目录前言一、数据集二、训练Scikit-learn模型三、基于MLSever构建Scikit-learn服务四、测试模型五、训练XGBoost模型六、服务多个模型七、测试多个模型的准确性总结参考前言在过去我们训练模型,往往通过编写flask代码或者容器化我们的模型并在docker中运行。这篇文章中,我们......