写blog也有一年多了,不能说笔者blog或者技术多好,但是在如何写blog上却是有笔者的一些见解。无论各位是新手,还是技术大牛,都会写一些blog来记录自己的经历。都有自己的写作风格,以下只是笔者个人观点。
1.别人写过的blog,请不要再写了。如今,我们在查找资料的时候大多是借用搜索引擎,搜索引擎做的很好,但它有时也不能把所有相同的内容过滤掉。所以当我们google某个内容的时候,有时第一页显示出来的内容都是一样的。要么是不同的人写的; 要么是一个人写的一份,在几个不同的blog网站上贴出来。笔者个人很不喜欢这样的行为。幻想一下,当各位去搜某个内容的时候,半天都是相同的内容,各位看官的心情如何呢?我们发的每一篇文章要有质量(不要抬杠啦,笔者的blog质量不高啦),而不是要在乎自己发表blog的数量。而如果各位同时维护着几个不同的blog,不觉的累吗?那干脆自己做个blog站点好啦,凭你的技术不算难吧?
2.不要翻译guide。原因如下:某些技术的文章,都会对应一个cn的guide,如果没有,各位大可考虑和官方联系一下,建立一个中文的guide文档的站点,或者贡献你的力量。另外,如果一个技术人,连一篇英文文档都读不懂的话,那只能说他只是一个coder。这话没有任何瞧不起其他程序员的意思,笔者也是程序员,但是程序员要去自学,要去查文档,而不是墨守城规。文档还是官方的好,因为总感觉翻译过来的文档已经变味了。
3.整理写作的逻辑思维,先干什么,再干什么,中间可能出现什么问题。这时候程序员就像是一名老师,不单单要教会别人技术,而且要告诉别人你思考问题的思路。阅读的人,觉得你的思路好,可以兼容学习;觉得不好,大可不去学。有则改之,无则加冕。
4.优化你的代码结构。我很讨厌去某些网站上去看文章,因为这些网站上的blog没有采用markdown。这也是我为什么选择iteye来写blog,看中的就是markdown。同事在xx网上写blog,通通没有采用markdown,我问为什么,有的说,没提供;有的说,有,不好使。总归是没有。看了有些博主的文章。代码之间连换行都没有,这样的文章如果是博主自己看,可能会明白。如果是别人呢?也能明白,只不过费点力罢了。
5.不要罗列内容。有人喜欢把blog作为自己记录自己成长点滴的地方。我们应该鼓励,但罗列学习的内容是没有意义的。比如今天学习了javasript,学习了它的string,有xx方法;学习了array, 有yy方法。这有什么意义呢?方便别人查api吗?这个官方api我觉得比你写的好。个人认为,blog的内容应该是自己学习的感想,感悟,学习的方法。
6.不要翻译api。貌似和前面的说的相似。但是这样的情况也很多。通篇在说某个对象的下面的函数,拜托,这些内容官方api上是有的。如果你想写的话,你可以写某个接口的深入剖析啊。实在想写的话,就写一个学习笔记好了。
你是笔者,也是读者。总之,你写的blog,要让自己成为第一个读者,自己能够看着舒服。
相关推荐
NULL 博文链接:https://jiony.iteye.com/blog/785993
> 这里主要记录一下博主开发中遇到的一些问题,很多都是一些细节,开发中多注意一点。 js代码的引入 > 引入模块化的js代码使用的是相对目录,../类似于cd ..返回上一层目录 var netUtils = requ
1.版本:matlab2022A,包含仿真操作录像,操作录像使用windows media player播放。 2.领域:模糊图像融合 ...5.注意事项:注意MATLAB左侧当前文件夹路径,必须是程序所在文件夹位置,具体可以参考视频录。
网上博客的文章很多存在一些小错误。 细节问题没做好。 现在我把自己的操作成功的实例重新演练一遍,基本跟大家啊网上参考的一致,请注意every setp 。我的习惯,先写一个文章大纲: 软件配置。 构建Web ...
详解BOM表+C0603封装绘制流程+元件封装其它注意点总结+原理图转到PCB流程3.网络表概念解读+板框绘制4.模块化布局5.布线铺铜设计规则设置6.布线铺铜实战及细节详解7.DRC设计规则检查+优化与丝印调整+打样与PCB生产...
wordpress博客是一个开源博客程序,也是使用人数最多的.静态化的处理需要使用静态插件来达到很多空间是不需要插件来静态化的,重写url规则就开源达到静态化的处理了,感兴趣可以祥看本
注意啦 注意啦 最新的教程已经更新 地址是https://blog.csdn.net/u013115157/article/details/64123846 有兴趣的朋友可以去博客中看看 1. 内容更加全面,更多细节,更多知识点全部在新版本中有所体现,并且会附上小...
注意,程序只是提供了功能,具体实现参看FFT的推导(https://blog.csdn.net/jaz/article/details/122575504)。 2程序采用了生产者消费者、状态机的结构,以及通过事件结构进行交互,适合labview的学习。 3系统中...
注意:这是小工具,直接使用,具体代码开发细节如下: 采用C#调用LightingChart控件实现,具体开发关键记录参考链接: http://blog.sciencenet.cn/home.php?mod=space&uid=244606&do=blog&id=1242834
django-angular-blog 一个带有 django-rest-framework 和 angularjs 的博客应用程序。 注意:如果您收到此错误: “导入错误:无法导入设置‘blog.settings’(是否在 sys.path 上?):没有名为 local_setting 的...
由于五一前的这周工作需求不是很多,便趁着这个机会将博客迁移到了docker中,虽说网上docker相关文章有很多,第一次实践的我还是遇到了一些小问题,现在便来总结一下。 在这里我要推荐的是docker_practice(本站地址...
设计了一种具有压缩轴向和细节增强的注意力模块,使其能够更好的在移动端应用。 通过这篇文章能让你学到: 如何使用数据增强,包括transforms的增强、CutOut、MixUp、CutMix等增强手段? 如何实现SeaFormer模型实现...
这是博主最近一家大公司的面试题,写一个装饰器,限制函数每10s调用一次。当时是笔试的,只写了大概的代码,回来后温习了python装饰器的基础知识,把代码写完了...不带参数的装饰器需要注意的一些细节 1. 关于装饰器函
提供的源码资源涵盖了安卓应用、小程序、Python应用和Java应用等多个领域,每个领域都包含了丰富的实例和项目。这些源码都是基于各自平台的最新技术和标准编写,确保了在对应环境下能够无缝运行。同时,源码中配备了...
前言,看到网上很多相关的帖子,但是有些小细节介绍的不够详细,所以想写一篇入手篇,以供新手参考;另外注意,如果增加了资源文件,需要qmake一下,否则可能会构建失败; 详细说明:...
还有,注意中英文间用一个半角空格隔开,排版会漂亮很多,简历承载的不仅是内容,还有细节和态度,上面这些点往往都反映着面试者的代码风格、做事的认真程度。当然,简历写的很漂亮但面聊之后发现啥都不会的也有,...
然后,一些小细节我就不说了,相信开发学生成绩管理系统的你也已经大致了解了MFC的基本概念。有一个特殊的点,我希望大家做实验前可以注意:就是在属性那里把Unicode改成多字节,否则,你会在实验中遇到各种各样的令...
关亍 kafka 的实现细节,返主要就是讲 design 的部分:《细节上》、《细节下》 关亍 kafka 开収环境,scala 环境的搭建:《开収环境搭建》 数据生产者,producer 的用法:《producer 的用法》、《producer 使用注意...