写编程书的作者注意啦!

编程书中代码很多,写代码的时候要注意:

1.系统自动生成的代码,尽量删除,不要放到书中,有占用篇幅的嫌疑,用省略号代替,简单说明即可。

2.如果有英文注释,都翻译成中文,咱们的书是给中国人看的,所有的注释都用中文

3.代码注释要详细,平均两行一个注释,不怕多,越多越好

4.注释的时候,单行注释放到代码的右侧,不要另起一行,以节约篇幅。

如何避免:

(1)首先在编译器中调试好程序,确定输出结果正确

(2)然后再把代码复制到word中。

这个顺序不要错,有些人在书中写代码,然后在程序中调试成功,结果书中是错的,这样会误导读者,类似问题太多,会导致图书下架,赔偿出版社损失。

你可能感兴趣的:(写编程书的作者注意啦!)