

写作笔记之二:关于重写 — blog.huangz.me
source link: https://blog.huangz.me/diary/2016/notes-about-writing-2.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

写作笔记之二:关于重写¶
最近这一个月, 我都在对《Redis使用教程》一书的书稿进行修正工作, 并对大量内容进行了重写。
写作中的重写和编程中的重构差不多, 都是为了提高内容的品质, 而在已有内容的基础上进行修正和改写。
对于技术图书的写作而言, 重写通常与经验以及技术升级有关, 本文接下来将分别对这两方面进行介绍。
因为经验累积而导致的重写¶
写作是一门非常需要经验的工艺, 作者在写作方面的功夫越深, 钻研的时间越长, 在写作技术和方法方面的积累也就越多, 而这种积累通常需要花费一定的时间才能有所长进。
以《Redis使用教程》为例子, 这本书最初的章节大概是在一年多之前写的。 因为我在这一年多以来写作《Redis使用教程》的过程中又积累了不少经验, 所以当我现在回过头去看一年多之前写的内容时, 就会发现很多内容都已经不再能够满足我的要求了, 因此对这些内容进行重写就成了自然而然的选择。
对于读者来说, 当他们看到一本书的时候, 这本书对于他们来说通常就是崭新的“第一版”。 但是对于作者来说, 在一本书正式出版之前, 为了让书本达到足够好的标准, 书本的内容通常都会经历好几次的重写。 因此从某种角度来说, 当一本书正式出版时, 它可能已经是这本书的“第二版”、“第三版”, 甚至更多。
因为技术升级而导致的重写¶
除了经验累积之外, 导致书本重写最常见的就是技术升级了。 技术图书的写作对象是某种技术或者某种软件, 而这些对象通常是会随着时间的流逝而变化的, 对于热门的技术来说, 更是如此。
还是以《Redis使用教程》为例, 在我刚开始写这本书的时候, Redis 的版本还是 3.0 , 那时 Redis 还只有无持久化、RDB 持久化和 AOF 持久化三种持久化模式, 所以我可能会在书本上写下“Redis只有三种持久化模式”这样的句子。 但是随着 Redis 4.0 的释出, Redis 又新增了一种 RDB-AOF 混合持久化模式, 因此上面的这段话就不再正确了。 为了修正这个问题, 我必须把上面的句子改为“Redis支持四种不同的持久化模式”, 并给书本加上关于 RDB-AOF 混合持久化模式的介绍内容。
技术升级一直以来都是技术图书写作的一大问题, 书中介绍的技术更新得越快, 作者对书本的重写工作就会越多, 在最极端的情况下, 图书的更新赶不上技术的更新也是有可能的, 不过作者一般都会尽量地避免这种情况发生, 毕竟谁都不会想让自己的书一出版就过时了。
Recommend
-
16
QQ 群聊天记录 001 号:关于盗版书的讨论¶ 在我创建的两个技术 QQ 群里面, 时不时会出现一些有趣的讨论内容, 有群友建议我把这些内容记录下来并在网上进行分享, 我一直觉...
-
11
翻译笔记之十三:慎选原著¶ 在前面的翻译笔记中, 我们一直考虑的是如何通过各种翻译技术和手段来提高译文的质量。 但是想要得到好的译文, 除了译者的翻译技术要好之...
-
8
写作笔记之一:写作手法的重要性¶ 对于大多数人来说, 写作首先考虑的是内容的质量, 但除了质量之外, 还有一点也非常重要, 那就是写作手法的选择。 正确的...
-
12
翻译笔记之六:译注有毒¶ 读者讨厌译注, 一个译注就是一个 GOTO , 它妨碍了读者以最自然的顺序阅读内容。 一般来说, 我们在阅读时的顺序总是从左到右...
-
9
关于编写参考手册的思考¶ 自从本月月初完成了《Redis in Action》的翻译工作之后, 我就开...
-
27
翻译笔记之二:翻译的定义¶ 从字面上来说, “翻译”不过是把内容从一种语言转换为另一种语言, 是一种单调而乏味的活动。 但实际上, 翻译内容只是翻译工...
-
7
Go 1.18 关于泛型特性的说明¶ 本文由黄健宏翻译自
-
6
jackson 学习之二:jackson-core 作者:程序员欣宸
-
17
Nuxtjs3 重写 blog 过程备忘 2022-05-10 tech
-
2
关于 Git 重写历史的一些笔记 傍晚时分,你坐在屋檐下,看着天慢慢地黑下去,心里寂寞而凄凉,感到自己的生命被剥夺了。当时我是个年轻人,但我害怕这样生活下去,衰老下去。在我看来,这是比死亡更可怕的事。——–王小波 ...
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK