说正事，回答你的帖子啊

来源: 美国老土于 2023-06-04 17:18:27 [档案] [博客] [旧帖] [给我悄悄话] 本文已被阅读：次 (4620 bytes)

回答: 工作笔记1-误解及影响由石榴花开的季节于 2023-05-30 15:30:29

Backup/测试 code—我工作的单位是业务部门，做的产品要24 小时都运行。如果因为任何原因中断就算事故。因此如果有新产品需要上业务，或是产品需要更新，都不能直接在业务运行的计算机上改，而是要先在测试的计算机上调试好了以后，才能搬到业务上去。但是在业务上运行的code和在测试机上运行的不是完全一样的。code 从测试机搬到业务上后需要做一些小改动。比如测试时输出的测试信息需要关掉。上了业务之后才要发出的数据和信息需要打开，等等。这样就有一个版本的问题。我们这里虽然有code 的configuration management (CM), 但是也非常混乱。很多人就给测试版的code名加_bk 以区别正式版的code。比如业务上的code, ingest.pl 在测试机上就是ingest_bk.pl. 这个code搬到业务机上后，要去掉_bk，改回原来的名字。但是时间长了，人员也变动频繁，我就在业务机上看到一堆*_bk code，也不知道人们是不知道应该去掉_bk,还是忘了这样做。唉，早知如此，何必加_bk?

-- 历史上就是这样加的；
-- 而就形成了历史；
-- 只要一切都工作的好好的，千万不要去多事；
-- 怕就怕你把文件名字了以后，看着挺规范，但生产系统有可能就出问题了。

文档—-有关软件的文件是非常重要的，它对一个系统的安装和维护是必不可少的。但是我很少看到写得好的文档。经常是文档大的不得了，似乎包罗万象，很全面。但是我的感觉是想要找的重要信息找不到，不想要的一大堆。而且几种文档中的信息互相重复。总而言之，垃圾信息一大堆，重要信息找不到，或者很难找到。如何写好文档，应该包括那些内容，如何取舍内容，…，可能是一个很大的问题。我曾经参加过制定文档标准的工作。但是我只是更了解这个新的文档标准，我的意见当时并没有被接受。新标准规定每个数字产品都需要写一个user manual 。user manual 分两种，external user manual (eum)和 internal user manual (ium). 我们这里大部分产品只需要写eum, 只有一个产品需要写ium. (我的看法是根本就不要搞一个ium). 结果是，虽然我们在文档标准里说明了什么产品需要eum , 什么产品需要ium。但是认真读说明的人可能都不多，而误读的人却总是那么的多。于是我就看到很多产品都写了eum and ium 两个文件。 eum 和ium 里的内容又是很多重复。人们又都搞不明白eum 和ium 的区别, 有的人干脆只写了一个ium ，其实他应该只写一个eum. 总而言之文档这里也是一片混乱。唉！大概到处都是这样乱糟糟？

-- 写文档是领导布置的任务；
-- 写了就是表示尊重领导了，就算是交差了。