Comments (4)
bluebore
commented on May 30, 2024
这个真心比较难，慢慢来吧~
from tera.
00k
commented on May 30, 2024
如果注释是用来描述代码的，那规范的代码本身比注释更容易被程序员理解
如果注释是用来描述设计的，那么还是用文档的形式表现出来会更好，毕竟会更集中、更抽象
所以我认为有两个地方需要注释，一是算法非常复杂，看代码不容易理解；二是对API的描述
其他情况下注释都可以用代码或文档取代
头文件中大段的注释可能只是把文档写在了代码中
你觉得呢
from tera.
BabySid
commented on May 30, 2024
可以接受。系统设计一般不放在代码中。单独列出比较合适。
对于代码中的注释，更多于接口功能说明。(.h)
对于实现的注释，可以是较复杂逻辑的背景原因解释。(.cpp)
from tera.
00k
commented on May 30, 2024
好的，后面我们会按照这个原则进行开发
from tera.
Related Issues (20)
- fix teracli scan null key
- leveldb数据爆增 HOT 7
- The safe mode threshold is too high
- 现在除了百度，还有哪些企业在用tera？ HOT 3
- Add UnitTest for trackable gc
- trackable gc cannot clean empty tablet dir
- remove IncrementalGcStrategy
- SDK发送一个任务给服务器成功后，过了一定时间SDK内部超时管理器认为任务超时，返回错误码给teracli,teracli析构了TableImpl，但是这时服务器把先前的任务又返回了，但是TableImpl已经析构了，就会崩溃是吗？ HOT 5
- when a tabletnode node dead， tablets on it cannot use until this node is ready？ HOT 6
- stop master and does not use kill -9 ， master will crash at MasterZkAdapter destruction func。error code Device or resource busy HOT 4
- 异步Put操作，Table实例释放问题。 HOT 3
- 通过Append接口放入多条数据，读出来时会有数据丢失 HOT 1
- 内存泄漏问题 HOT 3
- build.sh package not found HOT 1
- Scan on non-existent column family should fail earlier
- 这里可能有一个bug？ HOT 1
- merge 2.14 to master
- tera 是线上检索的doc server吗？ HOT 2
- tera client客户端连接问题 HOT 3
- 请问是否有GlobalTranaction 介绍文档呢？ HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from tera.