如何写好技术文章

作为程序员,很多时候面对两难的问题。代码开发阶段,由于项目进度原因,很少人会主动写文档;另一方面,后期维护阶段,或者维护其他人的项目,又会抱怨缺少文档,代码混乱等。

仔细想一下,问题解决的方法其实不难,那就是从自己开始,有意识在平时的工作中写技术文档。在自媒体平台,比如微信公众号上写文章,确实不是一件容易的事情,但是在项目中写

技术文档,相对来说来是比较容易的。因为起码选题,内容不用愁了,且这些文档对遣词造句的要求也不高,重点是把问题背景,技术原理,解决方法,主要问题,下一步工作写清楚就行。

因此,对于程序员来说,写好技术文档,或者说技术文章,就是一件比较重要的事情了。这里推荐一份阮一峰github上针对如何写好技术的文章的一些要求规范,可能会对你有所帮助。

github地址:https://github.com/ruanyf/document-style-guide

原文地址:https://www.cnblogs.com/lionelgeng/p/12045994.html

时间: 2024-11-13 22:48:36

如何写好技术文章的相关文章

【 随笔 】 为什么要写技术文章

去年,我开设了专题站,主要讲解数据可视化开发库D3的使用方法,文章写得不好,但相信还是为一些人的学习提供了些许方便.我想谈谈为什么要把写技术文章. 第一,写文章能极大地加深自己对此技术的理解,长时间写技术博客的人相信都有这种感受.根据文章阅读对象的不同,这种情况又分为两类.第一类是写文章完全是为了让自己看,以备将来记不清的时候查询.第二类是写文章是为了让别人看的,为了分享给其他人的.那么这两者哪一种更能达到目的,即加深作者对此技术的理解呢?多数情况下是第二种.因为当一篇文章写作的目的就是为了让别

【转】研究生如何读文献 写论文 发文章 毕业论文

研究生论文写作步骤 1. 先看综述,后看论著.看综述搞清概念,看论著掌握方法.2. 早动手在师兄师姐离开之前学会关键技术.3. 多数文章看摘要,少数文章看全文.掌握了一点查全文的技巧,往往会以搞到全文为乐,以至于没有时间看文章的内容,更不屑于看摘要.真正有用的全文并不多,过分追求全文是浪费,不可走极端.当然只看摘要也是不对的.4. 集中时间看文献,看过总会遗忘.看文献的时间越分散,浪费时间越多.集中时间看更容易联系起来,形成整体印象.5. 做好记录和标记复印或打印的文献,直接用笔标记或批注.pd

2017上半年技术文章集合【Android】—184篇文章分类汇总

地址: http://blog.csdn.net/androidstarjack/article/details/77923753 声明 | 本文是于亚豪 原创 终端研发部 前言: 2017年已经过大半,公众号里技术文章整理和归类了一下,方便给大家查找和阅读.这也是目前 发文的一个统计. View篇: 高级UI特效之酷炫抢红包金币下落动画 一个超级方面的用户指引view-App实现用户指引就是如此简单 让View像粒子一样自由运动 手把手教你实现RecyclerView实现上拉刷新功能 高级UI

技术文章写作及运营的技巧:分析篇 | 什么样的文章受欢迎?

对于以技术为核心的技术博客来说,人们是冲着他们需要的内容去的,绝大多数情况下都不是在闲逛.如果你的网站里没有他想要的东西的话,他便会离开,人们是出于目的去搜索,基于动机,而不是无聊的在闲逛.无聊的话,他们更多的会去刷刷朋友圈的,看看鸡汤. 文章的类型 依据我的经验,我将技术博客分为下面几种类型: 文章类型 频率 时间 技术细节型 几次/天 15~30分钟 干货型 几次/月 1~2小时 实践总结型 几次/ 周 2+小时 杂谈与鸡汤型 几次/季度 1 + 小时 ~ 几个月 并且他们的流量来源大概来源

28.为什么技术文章阅读量只几千,鸡汤文却轻松过万

前段时间,timyang(新浪微薄技术总监)在群里发问:"我的疑惑是所有比较受欢迎的技术文章,阅读数为什么停在几千:朋友圈看到也不点,由于阅读数上不去,大家都要拼标题". 这是个很有意思的话题,我们可以借此为契机,看一下在pc互联网和微信中: 1.      信息传播的变化 2.      各自属性 1.    信息传播的变化 在传统的互联网中,获取信息的主要渠道是什么? 是搜索!!!造就了百度的搜索. 搜索有什么特点? 1.      具有主动性.当我搜索的时候,是对某个技术感到兴趣

技术文章的阅读姿势

阅读技术文章可以说是我们程序员的日常之一,Peak 君每天也会进行定量的阅读.特写一篇小文分享下心得,介绍下过去几年,在纠正阅读习惯上所做的一些努力和取得的成果,或许可以帮助一些朋友,节省少许阅读时间,提升一点学习效率. 差不多两年前,我开始搭建 Android 相关的知识体系.最开始的想法是从基础知识的积累开始,正好这几年社区的技术分享盛行,「掘金」.「开发者头条」.「简书」等渠道上每天都有大量的新文章发布,文章主题五花八门,内容深浅不一,看上去都很不错.可坚持读了几天之后,深感自己踏进了错误

《PHP内核探索系列文章》系列技术文章整理收藏

<PHP内核探索系列文章>系列技术文章整理收藏 PHP内核探索系列文章收藏夹收藏有关PHP内核方面的知识的文章,对PHP高级进阶的朋友提供PHP内核方面的知识点探讨 1PHP内核探索:从SAPI接口开始 2PHP内核探索:一次请求的开始与结束 3PHP内核探索:再次探讨SAPI 4PHP内核探索:Apache模块介绍 5PHP内核探索:Zend引擎 6PHP内核探索:多进程/线程的SAPI生命周期 7PHP内核探索:单进程SAPI生命周期 8PHP内核探索:一次请求生命周期 9PHP内核探索:

从进入这里,没有写过什么文章,现在开始吧

从进入这里,已有5个年头了,也没有写过什么文章,就从现在开始吧!有时间写些学习的心得体会,对自己的反思,也是对别人的帮助. 像我一样从事编程工作的人,一样迷茫的共同探索未来的路. 现在有时间,细细汇总下这些年已学习的技术: 客户端:html,css,javascript,jquery,easyui,extjs, 服务器:asp,asp.net(webform,mvc),php,python,wpf,silverlight,wcf,wf,xml 数据库:oracle,mssql,mysql,nos

《PHP框架ThinkPHP学习》系列技术文章整理收藏

<PHP框架ThinkPHP学习>系列技术文章整理收藏 1修改ThinkPHP缓存为Memcache的方法 2Thinkphp实现MySQL读写分离操作示例 3ThinkPHP调用百度翻译类实现在线翻译 4使用ThinkPHP+Uploadify实现图片上传功能 5Thinkphp使用mongodb数据库实现多条件查询方法 6ThinkPHP实现多数据库连接的解决方法 7改写ThinkPHP的U方法使其路由下分页正常 8ThinkPHP实现将SESSION存入MYSQL的方法 9ThinkPH